Multi-Agent Simulation Framework

Hanzo Bot

A powerful framework for creating, deploying, and managing autonomous AI agents. Build intelligent systems that can interact across multiple platforms while maintaining consistent personalities and knowledge.

As seen powering@DegenSpartanAIand@aixvc_agent

Key Features

Designed with flexibility and extensibility in mind to power the next generation of AI agents

Platform Integration

Clients for Discord, X (Twitter), Telegram, and many other platforms

Flexible Model Support

Use Deepseek, Ollama, Grok, OpenAI, Anthropic, Gemini, LLama, and more

Character System

Create diverse agents using characterfiles with unique personalities

Multi-Agent Architecture

Manage multiple unique AI personalities simultaneously

Memory Management

Easily ingest and interact with documents using RAG for better context

Media Processing

PDF, URLs, Audio, Video, Image analysis, and Conversation summarization

Technical Foundation

100% TypeScript implementation with modular, extensible architecture

Comprehensive API

Well-documented interfaces for extending and customizing behavior

Architecture

A modular system designed for flexibility and extensibility

Source: https://x.com/0xCygaar/status/1874575841763770492
Modular Architecture

Visualization of the Hanzo Bot architecture would appear here

Character Files

Contains the agent's personality, backstory, knowledge, and topics to discuss. It also defines which clients, models, and plugins to load.

Database

Stores relevant information for generating responses, including previous interactions and embeddings. Essential for contextual responses.

Runtime

The core agent logic that coordinates between modules and external services. It processes inputs through the LLM and generates responses or action items.

Clients

The platforms where agents interact with users (Discord, Twitter, Slack, Farcaster). Agents can run on multiple clients simultaneously.

Use Cases

Hanzo Bot can be used to create a wide variety of autonomous agents

AI Assistants

  • Customer support agents
  • Community moderators
  • Personal assistants

Social Media Personas

  • Automated content creators
  • Brand representatives
  • Influencers

Knowledge Workers

  • Research assistants
  • Content analysts
  • Document processors

Interactive Characters

  • Role-playing characters
  • Educational tutors
  • Entertainment bots

Getting Started

Begin your journey with Hanzo Bot in a few simple steps

Prerequisites

  • Python 2.7+
  • Node.js 23+
  • pnpm
  • Note for Windows Users: WSL 2 is required

Automated Start

git clone https://github.com/hanzoai/bot-starter.git

cd bot-starter

cp .env.example .env

pnpm i && pnpm build && pnpm start

OR

git clone https://github.com/hanzoai/bot

cd bot

sh scripts/start.sh

The start script handles all dependencies, environment setup, and character management automatically.

Quickstart Guide

For a more detailed guide, check out our comprehensive documentation

Ready to create your first autonomous AI agent? Our detailed quickstart guide will walk you through every step.

Documentation

Comprehensive guides to help you build, deploy, and manage your agents

Getting Started

Core Concepts

Guides

Advanced Topics

View Complete Documentation

Community and Support

Join us in building the future of autonomous AI agents with Hanzo!

Next Steps

  • 1
    Create Your First Agent

    Follow our guide to build your first AI agent

  • 2
    Understand Core Concepts

    Learn about the key components of the Hanzo Bot framework

  • 3
    Explore Advanced Features

    Discover how to leverage the full potential of your agents

Looking for examples?

View ready-to-use character templates and implementations →
Last updated on Feb 20, 2025 by jin