Autonomous Agent Framework for the Decentralized Web
View on GitHub →

What is Eliza OS?

Eliza OS is a powerful open-source autonomous agent framework designed for building intelligent, independent AI agents that can operate across the decentralized web. It provides a complete infrastructure for creating bots that can autonomously interact with users, process information, and execute actions through a modular, extensible architecture.

Built on modern web technologies, Eliza OS enables developers to create agents with personalities, memories, and capabilities that go far beyond simple chatbots. These agents can learn from conversations, maintain context over time, and integrate with various services and platforms.

Core Purpose

Eliza OS aims to democratize AI agent development by providing:

Architecture 🏗️

Eliza OS is built on a modular architecture that separates concerns into distinct, interchangeable components:

┌─────────────────────────────────────────────────────┐ │ Agent Core │ │ ┌──────────────┐ ┌──────────────┐ ┌─────────────┐│ │ │ Character │ │ Memory │ │ Context ││ │ └──────────────┘ └──────────────┘ └─────────────┘│ └─────────────────────────────────────────────────────┘ ↓ ↓ ↓ ┌─────────────────────────────────────────────────────┐ │ Skills │ │ ┌──────────────┐ ┌──────────────┐ ┌─────────────┐│ │ │ Actions │ │ Evaluators │ │ Clients ││ │ └──────────────┘ └──────────────┘ └─────────────┘│ └─────────────────────────────────────────────────────┘ ↓ ↓ ↓ ┌─────────────────────────────────────────────────────┐ │ Providers │ │ ┌──────────────┐ ┌──────────────┐ ┌─────────────┐│ │ │ Models (AI) │ │ Services │ │ Storage ││ │ └──────────────┘ └──────────────┘ └─────────────┘│ └─────────────────────────────────────────────────────┘

Key Components

Features & Capabilities ✨

🧠 Intelligent AI Models

Support for multiple AI providers including OpenAI, Anthropic, and local LLMs. Switch models seamlessly and optimize for different use cases.

💾 Persistent Memory

Agents remember conversations, learn from interactions, and build knowledge over time using various storage backends.

🔌 Extensible Skills

Build custom actions, evaluators, and client integrations. The plugin system lets you extend capabilities without modifying core code.

🌐 Multi-Platform Support

Deploy agents across Discord, Twitter, Telegram, and custom platforms. A single agent can maintain context across multiple channels.

⚙️ Character Configuration

Create unique personalities with detailed character definitions, allowing for roleplay, specialized expertise, or consistent brand voices.

🔗 Web3 Integration

Native support for blockchain interactions, wallet connections, and decentralized applications. Built for the crypto-native ecosystem.

Getting Started 🚀

Eliza OS is built with TypeScript and runs on Node.js. Here's how to get started:

  1. Prerequisites:
    Ensure you have Node.js (v18+) and npm installed on your system.
  2. Clone the repository:
    git clone https://github.com/elizaOS/eliza.git
    cd eliza
  3. Install dependencies:
    npm install
  4. Configure your agent:
    Copy and customize the character configuration file to define your agent's personality and settings.
  5. Set up environment variables:
    Create a .env file with your API keys for AI providers and other services.
  6. Run your agent:
    npm run start

Configuration

Eliza OS uses character files (JSON) to define agent properties. You can customize:

Skills, Actions & Providers 🔧

Eliza OS's modular architecture makes it highly extensible:

Skills

Skills are packages of functionality that agents can learn. They include:

Providers

Providers supply backend services to the agent:

// Example character configuration
{
  "name": "Your Agent Name",
  "system": "You are a helpful AI assistant specializing in...",
  "bio": ["Background information about your agent"],
  "lore": ["Facts and knowledge about topics"],
  "messageExamples": [
    ["user", "message"], 
    ["assistant", "response"]
  ],
  "style": {
    "all": ["friendly", "professional"],
    "chat": ["conversational"]
  },
  "topics": ["AI", "technology", "your topics"]
}

Why Choose Eliza OS?

Eliza OS stands out in the AI agent landscape due to its focus on: