# heurist-agent-framework | Heurist | Knowledge Base | Instagit

A flexible multi-interface AI agent framework for building agents with reasoning, tool use, memory, deep research, blockchain interaction, MCP, and agents-as-a-service.

GitHub Stars: 779

Repository: https://github.com/heurist-network/heurist-agent-framework

---

## Articles

### [How FlaskAgent Implements the Delegation Pattern Using the `_parent` Attribute](/heurist-network/heurist-agent-framework/flaskagent-delegation-pattern-parent-attribute)

Discover how FlaskAgent implements the delegation pattern with its _parent attribute, enabling seamless attribute access and mutation for enhanced agent functionality. Learn more today.

- Tags: internals
- Published: 2026-03-03

### [How to Debug Heurist Mesh Agent Failure Modes: 7 Common Issues and Fixes](/heurist-network/heurist-agent-framework/common-agent-failure-modes-debugging)

Debug Heurist Mesh agent failures by understanding 7 common issues like network errors, rate limits, and timeouts. Learn quick fixes and troubleshooting tips for smooth operation.

- Tags: how-to-guide
- Published: 2026-03-03

### [ValidationManager in the Heurist Agent Framework: Input Validation and Integration Guide](/heurist-network/heurist-agent-framework/validationmanager-validate-agent-inputs-outputs)

Learn how the ValidationManager in Heurist Agent Framework pre-validates user messages using mention detection or LLM relevance checks, ensuring efficient agent workflows and preventing unnecessary processing.

- Tags: deep-dive
- Published: 2026-03-03

### [How to Configure and Use the LLM Provider for `call_llm` and `call_llm_with_tools` in Heurist Agent Framework](/heurist-network/heurist-agent-framework/configure-llm-provider-call-llm-call-llm-with-tools)

Configure and use the LLM provider in Heurist Agent Framework for call_llm and call_llm_with_tools. Learn to manage text completion and function calling efficiently.

- Tags: tutorial
- Published: 2026-03-03

### [How to Test Individual Agent Components and Defined Workflows in Heurist Agent Framework](/heurist-network/heurist-agent-framework/test-agent-components-workflows)

Easily test individual agent components and defined workflows with the Heurist Agent Frameworks built-in async test harness. Learn how to use the test_agent helper for efficient validation.

- Tags: testing
- Published: 2026-03-03

### [How to Integrate with Heurist Mesh Agents for Token Analytics and Blockchain Data Retrieval](/heurist-network/heurist-agent-framework/integrate-heurist-mesh-agents-token-analytics-blockchain-data)

Integrate Heurist Mesh agents for token analytics and blockchain data retrieval. Use MeshClient to send queries or tool calls for efficient data access and analysis.

- Tags: how-to-guide
- Published: 2026-03-03

### [How ConversationManager Handles Conversation History and Maintains Context Across Interactions](/heurist-network/heurist-agent-framework/conversationmanager-handle-history-context)

Discover how ConversationManager maintains context across interactions by storing message logs as embedded records. Learn how it uses VectorStorageProvider for full conversational background in LLM requests.

- Tags: internals
- Published: 2026-03-03

### [Deploying Heurist Agents in Production: Threading Model and Daemon Process Guide](/heurist-network/heurist-agent-framework/deploy-agent-production-threading-model-daemon-processes)

Deploy Heurist agents using daemon threads and a leader process for robust production management. Ensure automatic cleanup and graceful shutdown for reliable background services.

- Tags: how-to-guide
- Published: 2026-03-03

### [How generate_image_with_retry_smartgen Works: Mechanism and Customization Guide](/heurist-network/heurist-agent-framework/image-generation-generate-image-with-retry-smartgen-customization)

Explore the generate_image_with_retry_smartgen mechanism in Heurist Agent Framework. Learn to customize model selection, image parameters, and retry logic for effective image generation.

- Tags: deep-dive
- Published: 2026-03-03

### [How to Implement Voice Processing Capabilities Using transcribe_audio and speak_text in Heurist Agent Framework](/heurist-network/heurist-agent-framework/implement-voice-processing-transcribe-audio-speak-text)

Implement voice processing in Heurist Agent Framework with transcribe_audio for speech-to-text and speak_text for text-to-speech. Learn how to use these functions and set OPENAI_API_KEY.

- Tags: how-to-guide
- Published: 2026-03-03

### [How PersonalityProvider Manages Agent Personality and System Prompts in Heurist Agent Framework](/heurist-network/heurist-agent-framework/how-personalityprovider-manages-agent-personality-system-prompts)

Discover how PersonalityProvider dynamically crafts system prompts by merging base configurations with unique personality traits, ensuring consistent LLM instructions with varied character. Learn more about the Heurist Agent Fr...

- Tags: internals
- Published: 2026-03-03

### [How to Integrate a New Heurist Mesh Agent to Leverage Web3 Data](/heurist-network/heurist-agent-framework/integrate-new-heurist-mesh-agent-web3-data)

Integrate a new Heurist Mesh agent for Web3 data by inheriting MeshAgent, implementing key methods, and allowing automatic discovery for LLM-driven queries.

- Tags: how-to-guide
- Published: 2026-03-03

### [How Heurist Agents Handle Multi-Threading: Message Queues and Locks Explained](/heurist-network/heurist-agent-framework/agent-multithreading-message-queue-locks)

Discover how Heurist agents manage multi-threading. Learn about thread-safe message queues and locks for concurrent agent interactions.

- Tags: internals
- Published: 2026-03-03

### [Essential Environment Variables for Running the Heurist Agent: Complete Configuration Guide](/heurist-network/heurist-agent-framework/required-environment-variables-run-heurist-agent)

Configure your Heurist agent successfully. Discover the essential environment variables like HEURIST_API_KEY, LARGE_MODEL_ID, and DYNAMODB_TABLE_NAME for optimal performance and production deployment.

- Tags: getting-started
- Published: 2026-03-03

### [How the Knowledge Retrieval (RAG) System Works with the KnowledgeProvider in Heurist Agent Framework](/heurist-network/heurist-agent-framework/how-knowledge-retrieval-rag-works-knowledgeprovider)

Learn how the Heurist Agent Framework uses the KnowledgeProvider to enable Retrieval Augmented Generation RAG for efficient knowledge retrieval and LLM prompt injection.

- Tags: internals
- Published: 2026-03-03

### [Implementing a Custom Workflow in Heurist Agent Framework: A Complete Guide](/heurist-network/heurist-agent-framework/implement-custom-workflow-chainofthought-research)

Learn how to implement a custom workflow in Heurist Agent Framework. This guide covers creating Python classes, handling LLM calls, and integrating workflows with agents. Get started today.

- Tags: how-to-guide
- Published: 2026-03-03

### [How MCP Integration Facilitates Connections to External Agents and Tools in Heurist](/heurist-network/heurist-agent-framework/how-mcp-integration-connects-external-agents-tools)

Discover how MCP integration in Heurist Agent Framework seamlessly connects LLM agents to external tools and agents using SSE and JSON schemas. Unlock powerful integrations today.

- Tags: how-to-guide
- Published: 2026-03-03

### [MessageStore PostgreSQL vs SQLite for Vector Storage: Implementation Guide](/heurist-network/heurist-agent-framework/message-store-postgresql-vs-sqlite-vector-storage)

Explore MessageStore for vector storage. Compare PostgreSQL with pgvector for production and SQLite for local development. Understand implementation differences and usage patterns.

- Tags: comparison
- Published: 2026-03-03

### [How to Add a New Platform Interface to the Heurist Agent Framework: Slack, WhatsApp, and Custom Integrations](/heurist-network/heurist-agent-framework/how-to-add-new-platform-interface-slack-whatsapp-heurist-agent-framework)

Learn to add new platform interfaces like Slack and WhatsApp to Heurist Agent Framework. Follow our guide to create wrappers and integrate custom solutions easily. Extend agent capabilities today.

- Tags: how-to-guide
- Published: 2026-03-03

### [How CoreAgent Initializes and Manages Its Components in the Heurist Agent Framework](/heurist-network/heurist-agent-framework/how-does-coreagent-initialize-and-manage-components-and-tools)

**CoreAgent performs a deterministic six-step boot sequence in [`agents/core_agent_refactor.py`](https://github.com/heurist-network/heurist-agent-framework/blob/main/agents/core_agent_refactor.py) that reloads environment varia...

- Tags: 
- Published: 2026-03-03