eliza

Autonomous agents for everyone

Stars: 15365

Visit

README:

Eliza 🤖

📑 Technical Report | 📖 Documentation | 🎯 Examples

🌍 README Translations

🚩 Overview

✨ Features

🛠️ Full-featured Discord, X (Twitter) and Telegram connectors
🔗 Support for every model (Llama, Grok, OpenAI, Anthropic, Gemini, etc.)
👥 Multi-agent and room support
📚 Easily ingest and interact with your documents
💾 Retrievable memory and document store
🚀 Highly extensible - create your own actions and clients
📦 Just works!

Video Tutorials

AI Agent Dev School

🎯 Use Cases

🤖 Chatbots
🕵️ Autonomous Agents
📈 Business Process Handling
🎮 Video Game NPCs
🧠 Trading

🚀 Quick Start

Prerequisites

Note for Windows Users: WSL 2 is required.

Use the Starter (Recommended for Agent Creation)

Full steps and documentation can be found in the Eliza Starter Repository.

git clone https://github.com/elizaos/eliza-starter.git
cd eliza-starter
cp .env.example .env
pnpm i && pnpm build && pnpm start

Manually Start Eliza (Only recommended for plugin or platform development)

Checkout the latest release

# Clone the repository
git clone https://github.com/elizaos/eliza.git

# This project iterates fast, so we recommend checking out the latest release
git checkout $(git describe --tags --abbrev=0)
# If the above doesn't checkout the latest release, this should work:
# git checkout $(git describe --tags `git rev-list --tags --max-count=1`)

If you would like the sample character files too, then run this:

# Download characters submodule from the character repos
git submodule update --init

Edit the .env file

Copy .env.example to .env and fill in the appropriate values.

cp .env.example .env

Note: .env is optional. If you're planning to run multiple distinct agents, you can pass secrets through the character JSON

Start Eliza

pnpm i
pnpm build
pnpm start

# The project iterates fast, sometimes you need to clean the project if you are coming back to the project
pnpm clean

Interact via Browser

Once the agent is running, you should see the message to run "pnpm start:client" at the end.

Open another terminal, move to the same directory, run the command below, then follow the URL to chat with your agent.

pnpm start:client

Then read the Documentation to learn how to customize your Eliza.

Automatically Start Eliza

The start script provides an automated way to set up and run Eliza:

sh scripts/start.sh

For detailed instructions on using the start script, including character management and troubleshooting, see our Start Script Guide.

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

Modify Character

Open packages/core/src/defaultCharacter.ts to modify the default character. Uncomment and edit.
To load custom characters:
- Use pnpm start --characters="path/to/your/character.json"
- Multiple character files can be loaded simultaneously
Connect with X (Twitter)
- change "clients": [] to "clients": ["twitter"] in the character file to connect with X

Add more plugins

run npx elizaos plugins list to get a list of available plugins or visit https://elizaos.github.io/registry/
run npx elizaos plugins add @elizaos-plugins/plugin-NAME to install the plugin into your instance

Additional Requirements

You may need to install Sharp. If you see an error when starting up, try installing it with the following command:

pnpm install --include=optional sharp

Using Your Custom Plugins

Plugins that are not in the official registry for ElizaOS can be used as well. Here's how:

Installation

Upload the custom plugin to the packages folder:

packages/
├─plugin-example/
├── package.json
├── tsconfig.json
├── src/
│   ├── index.ts        # Main plugin entry
│   ├── actions/        # Custom actions
│   ├── providers/      # Data providers
│   ├── types.ts        # Type definitions
│   └── environment.ts  # Configuration
├── README.md
└── LICENSE

Add the custom plugin to your project's dependencies in the agent's package.json:

{
  "dependencies": {
    "@elizaos/plugin-example": "workspace:*"
  }
}

Import the custom plugin to your agent's character.json

  "plugins": [
    "@elizaos/plugin-example",
  ],

Start Eliza with Gitpod

Deploy Eliza in one click

Use Fleek to deploy Eliza in one click. This opens Eliza to non-developers and provides the following options to build your agent:

Start with a template
Build characterfile from scratch
Upload pre-made characterfile

Click here to get started!

Community & contact

GitHub Issues. Best for: bugs you encounter using Eliza, and feature proposals.
elizaOS Discord. Best for: hanging out with the elizaOS technical community
DAO Discord. Best for: hanging out with the larger non-technical community

Citation

We now have a paper you can cite for the Eliza OS:

@article{walters2025eliza,
  title={Eliza: A Web3 friendly AI Agent Operating System},
  author={Walters, Shaw and Gao, Sam and Nerd, Shakker and Da, Feng and Williams, Warren and Meng, Ting-Chien and Han, Hunter and He, Frank and Zhang, Allen and Wu, Ming and others},
  journal={arXiv preprint arXiv:2501.06781},
  year={2025}
}

Contributors

Star History

🛠️ System Requirements

Minimum Requirements

CPU: Dual-core processor
RAM: 4GB
Storage: 1GB free space
Internet connection: Broadband (1 Mbps+)

Software Requirements

Python 2.7+ (3.8+ recommended)
Node.js 23+
pnpm
Git

Optional Requirements

GPU: For running local LLM models
Additional storage: For document storage and memory
Higher RAM: For running multiple agents

📁 Project Structure

eliza/
├── packages/
│   ├── core/           # Core Eliza functionality
│   ├── clients/        # Client implementations
│   └── actions/        # Custom actions
├── docs/              # Documentation
├── scripts/           # Utility scripts
└── examples/          # Example implementations

🤝 Contributing

We welcome contributions! Here's how you can help:

Getting Started

Fork the repository
Create a new branch: git checkout -b feature/your-feature-name
Make your changes
Run tests: pnpm test
Submit a pull request

Types of Contributions

🐛 Bug fixes
✨ New features
📚 Documentation improvements
🌍 Translations
🧪 Test improvements

Code Style

Follow the existing code style
Add comments for complex logic
Update documentation for changes
Add tests for new features

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for eliza

Similar Open Source Tools

ONE is a modern web and AI agent development toolkit that empowers developers to build AI-powered applications with high performance, beautiful UI, AI integration, responsive design, type safety, and great developer experience. It is perfect for building modern web applications, from simple landing pages to complex AI-powered platforms.

github

: 58

fast-mcp

github

: 340

moling

github

: 125

ClaraVerse

ClaraVerse is a privacy-first AI assistant and agent builder that allows users to chat with AI, create intelligent agents, and turn them into fully functional apps. It operates entirely on open-source models running on the user's device, ensuring data privacy and security. With features like AI assistant, image generation, intelligent agent builder, and image gallery, ClaraVerse offers a versatile platform for AI interaction and app development. Users can install ClaraVerse through Docker, native desktop apps, or the web version, with detailed instructions provided for each option. The tool is designed to empower users with control over their AI stack and leverage community-driven innovations for AI development.

github

: 444

Shellsage

Shell Sage is an intelligent terminal companion and AI-powered terminal assistant that enhances the terminal experience with features like local and cloud AI support, context-aware error diagnosis, natural language to command translation, and safe command execution workflows. It offers interactive workflows, supports various API providers, and allows for custom model selection. Users can configure the tool for local or API mode, select specific models, and switch between modes easily. Currently in alpha development, Shell Sage has known limitations like limited Windows support and occasional false positives in error detection. The roadmap includes improvements like better context awareness, Windows PowerShell integration, Tmux integration, and CI/CD error pattern database.

github

: 52

farfalle

Farfalle is an open-source AI-powered search engine that allows users to run their own local LLM or utilize the cloud. It provides a tech stack including Next.js for frontend, FastAPI for backend, Tavily for search API, Logfire for logging, and Redis for rate limiting. Users can get started by setting up prerequisites like Docker and Ollama, and obtaining API keys for Tavily, OpenAI, and Groq. The tool supports models like llama3, mistral, and gemma. Users can clone the repository, set environment variables, run containers using Docker Compose, and deploy the backend and frontend using services like Render and Vercel.

github

: 2.1k

NextChat

NextChat is a well-designed cross-platform ChatGPT web UI tool that supports Claude, GPT4, and Gemini Pro. It offers a compact client for Linux, Windows, and MacOS, with features like self-deployed LLMs compatibility, privacy-first data storage, markdown support, responsive design, and fast loading speed. Users can create, share, and debug chat tools with prompt templates, access various prompts, compress chat history, and use multiple languages. The tool also supports enterprise-level privatization and customization deployment, with features like brand customization, resource integration, permission control, knowledge integration, security auditing, private deployment, and continuous updates.

github

: 78.7k

RookieAI_yolov8

RookieAI_yolov8 is an open-source project designed for developers and users interested in utilizing YOLOv8 models for object detection tasks. The project provides instructions for setting up the required libraries and Pytorch, as well as guidance on using custom or official YOLOv8 models. Users can easily train their own models and integrate them with the software. The tool offers features for packaging the code, managing model files, and organizing the necessary resources for running the software. It also includes updates and optimizations for better performance and functionality, with a focus on FPS game aimbot functionalities. The project aims to provide a comprehensive solution for object detection tasks using YOLOv8 models.

github

: 340

photo-ai

100xPhoto is a powerful AI image platform that enables users to generate stunning images and train custom AI models. It provides an intuitive interface for creating unique AI-generated artwork and training personalized models on image datasets. The platform is built with cutting-edge technology and offers robust capabilities for AI image generation and model training.

github

: 120

100x-LLM

This repository contains code snippets and examples from the 100x Applied AI cohort lectures. It includes implementations of LLM Workflows, RAG (Retrieval Augmented Generation), Agentic Patterns, Chat Completions with various providers, Function Calling, and more. The repository structure consists of core components like LLM Workflows, RAG Implementations, Agentic Patterns, Chat Completions, Function Calling, Hugging Face Integration, and additional components for various agent implementations, presentation generation, Notion API integration, FastAPI-based endpoints, authentication implementations, and LangChain usage examples.

github

: 187

orra

Orra is a tool for building production-ready multi-agent applications that handle complex real-world interactions. It coordinates tasks across existing stack, agents, and tools run as services using intelligent reasoning. With features like smart pre-evaluated execution plans, domain grounding, durable execution, and automatic service health monitoring, Orra enables users to go fast with tools as services and revert state to handle failures. It provides real-time status tracking and webhook result delivery, making it ideal for developers looking to move beyond simple crews and agents.

github

: 155

search_with_ai

Build your own conversation-based search with AI, a simple implementation with Node.js & Vue3. Live Demo Features: * Built-in support for LLM: OpenAI, Google, Lepton, Ollama(Free) * Built-in support for search engine: Bing, Sogou, Google, SearXNG(Free) * Customizable pretty UI interface * Support dark mode * Support mobile display * Support local LLM with Ollama * Support i18n * Support Continue Q&A with contexts.

github

: 785

ChatGPT-Next-Web

ChatGPT Next Web is a well-designed cross-platform ChatGPT web UI tool that supports Claude, GPT4, and Gemini Pro models. It allows users to deploy their private ChatGPT applications with ease. The tool offers features like one-click deployment, compact client for Linux/Windows/MacOS, compatibility with self-deployed LLMs, privacy-first approach with local data storage, markdown support, responsive design, fast loading speed, prompt templates, awesome prompts, chat history compression, multilingual support, and more.

github

: 78.5k

recommendarr

Recommendarr is a tool that generates personalized TV show and movie recommendations based on your Sonarr, Radarr, Plex, and Jellyfin libraries using AI. It offers AI-powered recommendations, media server integration, flexible AI support, watch history analysis, customization options, and dark/light mode toggle. Users can connect their media libraries and watch history services, configure AI service settings, and get personalized recommendations based on genre, language, and mood/vibe preferences. The tool works with any OpenAI-compatible API and offers various recommended models for different cost options and performance levels. It provides personalized suggestions, detailed information, filter options, watch history analysis, and one-click adding of recommended content to Sonarr/Radarr.

github

: 516

For similar tasks

No tools available

For similar jobs

No tools available

eliza

README:

Eliza 🤖

🌍 README Translations

🚩 Overview

✨ Features

Video Tutorials

🎯 Use Cases

🚀 Quick Start

Prerequisites

Use the Starter (Recommended for Agent Creation)

Manually Start Eliza (Only recommended for plugin or platform development)

Checkout the latest release

Edit the .env file

Start Eliza

Interact via Browser

Automatically Start Eliza

Modify Character

Add more plugins

Additional Requirements

Using Your Custom Plugins

Installation

Start Eliza with Gitpod

Deploy Eliza in one click

Community & contact

Citation

Contributors

Star History

🛠️ System Requirements

Minimum Requirements

Software Requirements

Optional Requirements

📁 Project Structure

🤝 Contributing

Getting Started

Types of Contributions

Code Style

For Tasks:

For Jobs:

Alternative AI tools for eliza

Similar Open Source Tools

eliza

markpdfdown

one

fast-mcp

moling

ClaraVerse

Shellsage

farfalle

NextChat

RookieAI_yolov8

photo-ai

100x-LLM

orra

search_with_ai

ChatGPT-Next-Web

recommendarr

For similar tasks

For similar jobs