Receive prompt
Use the CLI, Python API, FastAPI backend, or MCP-compatible editor workflow.
Limbi runs many specialized AI agents from one command, one Python API, or one MCP-compatible editor workflow. It keeps workspace memory, tracks execution, and supports both local models and cloud providers without forcing you into one narrow style of work.
Limbi is not trying to be a generic chat box. It is designed to coordinate work, preserve context, keep results auditable, and let you move between local and cloud providers without reworking the whole flow.
Limbi delegates work to specialized agents and brings the results back into one response, rather than making one model guess everything at once.
Shared session memory and episodic logs keep the current goal, route, and project context available across turns and across agents.
Ollama, local OpenAI-compatible servers, routers, and hosted providers all fit into the same workflow.
Limbi tracks runtime metrics, traces, and saved artifacts so you can see what happened and why.
These notes walk through Limbi in the same order a new user usually needs it: what it is, how it behaves, how to install it, and what happens after a prompt enters the system.
Limbi is not just a chat wrapper. It is an orchestration layer that chooses providers, routes tasks to agents, keeps workspace state, and tries to make the result auditable and repeatable.
You can install Limbi with Homebrew, the one-line curl installer, or pip. The docs explain when each route makes sense, plus what to check if the local setup or tap gets out of sync.
A prompt enters the CLI, the orchestrator loads memory and workspace context, decides whether the task should be researched, delegated, or handled directly, and then returns a concise answer with traces and runtime metrics.
The website ships through GitHub Pages and GitHub Actions. The product itself can run locally, with hosted providers, or through the provider modes and runtime settings described in the README.
The README follows the same path as the site: project focus, runtime behavior, agent catalog, capabilities, installation, provider selection, troubleshooting, and deployment. That means a visitor can start on the website and still find the deeper technical shape of Limbi without having to guess where to look next.
Limbi can load a provider-neutral agent.md file from the workspace root,
or an override from .limbi/agent.md, then share that guidance with the
orchestrator and every agent. That keeps behavior consistent whether the model is
local, hosted, or routed through a different provider.
Every request follows the same high-level path: load workspace context, classify the task, run the right agents, and return a response with a visible execution summary.
Use the CLI, Python API, FastAPI backend, or MCP-compatible editor workflow.
The orchestrator checks memory, route confidence, research context, and provider choice.
Structured delegation blocks send tasks to the right agent and action.
The response includes the result, runtime metrics, and a trace for review.
The platform is built to reduce the friction that usually appears when work is split across many tools, many prompts, and many provider endpoints.
One orchestration layer replaces a tangle of separate tools and manual copy-paste steps.
Specialized agents can focus on planning, code, research, operations, or review instead of guessing.
Shared memory keeps relevant project state available so the next turn starts with more than a blank slate.
Audit logs, traces, and runtime metrics show what happened instead of hiding it behind a single reply.
Limbi ships with a broad catalog for reasoning, engineering, cloud, security, business, and domain-specific work.
Limbi combines memory, research, skills, runtime metrics, and provider flexibility into one workspace-aware system.
Shared context uses graph-linked memory and episodic logs so the current goal, route, and project state survive across turns and agents.
Limbi can summarize a provided URL or search the web when the prompt asks for research without one.
Create, update, delete, export, and import skills. Keep them local, share them as packs, and let them inherit or pin a provider.
Pick the route that fits your machine. The page below matches the README install paths and keeps the commands easy to copy.
Homebrew is best for macOS, pip is the most direct Python route, and the one-line installer is useful for quick setup on Linux, macOS, and WSL2.
Limbi supports local model servers, hosted providers, and compatible OpenAI-style endpoints without changing your workflow.
If Brew or a local provider gets out of sync, these are the small repair steps that usually get you moving again.
Refresh the tap repo directly with git -C "$(brew --repo sayon999-d/limbi)" pull --ff-only and then run brew upgrade limbi.
Check that the base URL is local and that the selected model is actually installed. For Ollama, make sure the server is running and the model exists.
If a hosted model is retired, switch to a live model from /models and save the new preference.