eliza
TypeScript agents from character files and plugins, inside a product stack that now outweighs the framework
What is eliza?
You write a character file — a name, a system prompt, a few bio lines and the list of plugins to load — and the runtime turns it into an agent that stores each message, composes context from the providers the turn actually routes to, lets the model pick an action, and files what it learned through evaluators that run after the reply. First-party plugins ship in the same repository for the chat platforms people already use, MCP servers, browser and desktop control, calendar and inbox assistants, non-custodial EVM and Solana wallets, and an on-device model path that answers with the network off. Two things to weigh before adopting it: the repository is a whole product stack — desktop and mobile apps, a hosted cloud, native device bridges — so you take on far more than an agent library, and the stable release on npm is still the older 1.x line while the stack described here ships only under beta and alpha tags.
What can you do with eliza?
- Write the agent as a character file —
Characterholdsname, asystemprompt,bioandtopicsas lists of strings,messageExamplesas groups of example exchanges, andstyle, whoseallvoice is the shared one that bothchatandpostbuild on.pluginsnames the packages to load, andknowledgepoints at documents the agent can look things up in. - Learn which providers the runtime actually asks —
AgentRuntimestores the message, composes state, lets the model choose among registered actions, runs their handlers, then hands the turn to evaluators once the reply is out. Composition is selective: providers markedprivateordynamicare skipped outright, and the rest run only when their declaredcontextsmatch the ones the turn was routed to — declare nothing and you getgeneral, which drops out of narrow planner turns.alwaysInResponseStateis the opt-in for a signal that should always be there. - Add capability as a plugin object — A
Pluginexports any mix of actions (avalidatecheck plus ahandlerreturning success or failure), providers (agetreturning text and structured data), evaluators, long-running services, model handlers, HTTP routes, app views and event listeners. The 2.x beta CLI scaffolds one withelizaos create my-plugin --template plugin; on the 1.x release that npm still installs by default the same flag is--type plugin. - Put the agent where people already talk — Connectors for Discord, Telegram, Slack, WhatsApp, Signal, Matrix, WeChat, X, Instagram and iMessage ship in the repository, alongside
plugin-mcp, which reads servers fromsettings.mcp.serversand exposes their tools through a singleMCPaction, and assistant plugins for calendar, contacts, inbox, notes, todos and reminders. Of the hundred-plus plugin directories, roughly thirty are native device bridges that only do anything inside the Eliza app. - Run the models on the machine itself —
plugin-local-inferenceserves text generation, embeddings, transcription, Kokoro speech synthesis, image generation and image description on-device, needing no network once the model files land in~/.eliza/models. Routing is set per capability from the dashboard, so transcription can stay local while reasoning goes to a hosted provider. - Let it drive a browser or the desktop —
plugin-browseradds aBROWSERaction — open, navigate, click, type, fill, press, scroll, hover, drag, snapshot, screenshot — driving an embedded browser view, a paired Chrome or Safari extension, or a Playwright endpoint.plugin-computerusetakes the machine itself: screen capture, mouse and keyboard, window management, clipboard and OCR, with an approval inbox in front of it. Both are off until you enable them, and desktop input needscliclickon macOS orxdotoolon Linux.
Before you choose eliza
- As of August 2026 the stable npm tag for elizaos and @elizaos/core still resolves to the 1.x line last published in January, while the 2.x stack described here ships only under the beta and alpha tags.
- In August 2026 the founder said the ELIZAOS token was dead and the foundation winding down after a class-action settlement transferred the remaining treasury, while pledging that open-source development continues.
Star history
17 Aug to 30 Oct · +655
Frequently asked questions
Is eliza free for commercial use?
eliza is released under the MIT licence — OSI-approved open source, which permits commercial use.
How can eliza be deployed?
eliza is available as Self-hosted / Runs locally / Managed cloud.