This repository contains reference implementations to help developers integrate with Heurist AI services, including LLM, embedding, image generation, and using Heurist Mesh Agents.

All examples in this repository require a Heurist API key.

1. Create an API key by purchasing credits with crypto at Credits and API Management Portal
2. You can also apply for free trial credits using the form
3. Use this key in all examples by setting it as an environment variable or directly in the code

• Node.js (for JavaScript examples)
• Python 3.8+ (for Python examples)
• Heurist API Key (from steps above)

# Install dependencies for all JavaScript examples
npm install

# Create a virtual environment (recommended)
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install core dependencies for basic examples
pip install -r requirements.txt

# For specific advanced examples, install their additional dependencies:
# TokenIntel-TelegramBot
pip install -r mesh-agents/TokenIntel-TelegramBot/requirements.txt

# Google Sheets Data Pipeline
pip install -r mesh-agents/sheets-pipeline/requirements.txt

This repository is organized by functionality:

dev-examples/
├── basic/              # Basic integration examples
│   ├── llm/            # LLM examples (both JS and Python)
│   ├── embeddings/     # Embedding examples (both JS and Python)
│   └── image/          # Image generation examples (both JS and Python)
│
├── mesh-agents/        # Advanced Mesh Agent examples
│   ├── BlockBeak-TelegramBot/   # AI-powered Smart Telegram bot
│   ├── TokenIntel-TelegramBot/   # Crypto and web3 intelligence Telegram bot
│   └── sheets-pipeline/ # Google Sheets data pipeline

basic/llm/ - Access Large Language Models through Heurist's LLM Gateway.

Examples in both JavaScript and Python for:

• OpenAI SDK integration
• REST API integration
• Tool/function calling with Hermes Llama-3.1

LLM Gateway Documentation

basic/embeddings/ - Generate embeddings for semantic search and text analysis.

Examples in both JavaScript and Python for:

• OpenAI-compatible embeddings generation

basic/image/ - Generate images using Stable Diffusion models.

Examples in both JavaScript and Python for:

• REST API integration
• Heurist SDK integration (JavaScript)
• SmartGen for enhanced generation

Image Generation Documentation

mesh-agents/ - Specialized AI agents that provide domain-specific capabilities through API and MCP (Model Context Protocol).

mesh-agents/TokenIntel-TelegramBot/ - Integrates multiple specialized agents into a Telegram bot for crypto and web3 intelligence:

• ExaSearchAgent (web search)
• ElfaTwitterIntelligenceAgent (Twitter analysis)
• FirecrawlSearchAgent (advanced web search)
• SolWalletAgent (blockchain wallet analysis)

mesh-agents/sheets-pipeline/ - Data pipeline that:

• Fetches cryptocurrency and financial data
• Uses Google's Agent Development Kit (ADK)
• Connects to multiple MCP servers
• Automatically populates Google Sheets

mesh-agents/BlockBeak-TelegramBot/ - AI-powered smart Telegram bot that:

• Interfaces with specialized Heurist Mesh agents
• Supports both CLI and Telegram interfaces
• Uses MCP (Model Control Protocol) for agent connectivity
• Provides smart analysis on crypto market and information services

To build with Heurist Mesh Agents:

1. Get a Heurist API Key from the developer portal
2. Visit the Heurist Mesh MCP platform
3. Select your desired specialized agents
4. Create your dedicated MCP server
5. Use the MCP server URL in your application
6. Follow the examples in this repository

• Heurist Official Documentation
• Supported Models
• Mesh MCP Server Repository
• Mesh Agents Repository
• Create Your Own MCP Server