elizaOS

Your agentic operating system.

Eliza · Eliza Cloud · elizaOS downloads · Documentation

elizaOS is an open-source TypeScript framework and product stack for autonomous AI agents. This monorepo contains the core runtime, the Eliza app, the CLI, cloud services, native bridges, and first-party plugins. Linux and Android distribution tooling lives in packages/os.

Choose a starting point

| Goal | Start here | | --- | --- | | Use Eliza | Open the web app, visit Eliza downloads, or use a published GitHub release | | Run this repository | Follow Run Eliza from source | | Build an agent or plugin | Start with the runtime and the developer docs | | Contribute | Read the required contribution rules and AGENTS.md | | Run a whole device as elizaOS | Start with the build requirements and target guides in packages/os |

Run Eliza from source

The repository pins Bun and Node versions in package.json. Install those versions, then:

git clone --filter=blob:none https://github.com/elizaos/eliza.git
cd eliza
bun install
bun run dev

bun install also prepares submodules and patches, provisions supported host build prerequisites, and builds or verifies the staged desktop libelizainference. The embedding GGUF remains runtime-managed and downloads automatically during local-inference warmup. Fetch archived artifact fixtures explicitly with bun packages/scripts/fetch-archive-artifacts.ts when needed.

Common repository commands:

bun run dev:local   # app + API with the runtime chooser (local agent, own provider keys; Cloud sign-in not required)
bun run start       # run the standalone agent host (API only, no UI; use bun run dev for the app)
bun run build       # build the workspace with Turbo
bun run verify      # dependency, type, lint, and audit gates
bun run test        # repository end-to-end test lane
bun run test:e2e    # end-to-end lane
bun run cloud:mock  # local Eliza Cloud stack with mocks

Package build/test commands are in each package's README. Use bun run --cwd Chat with me