nexi-lab / nexus

The filesystem & context plane for AI agents Give every agent one place to read, write, search, remember, and collaborate — from a single-file script to a fleet of thousands. Documentation · Quickstart · Examples · PyPI · Roadmap --- Why Nexus Every agent framework gives you tool calling. None gives you a shared filesystem. Without one, agents duplicate files, lose context between runs, step on each other's writes, and can't discover what's already been built. Nexus fixes this. One VFS-style interface — start embedded in a single Python process, scale to a daemon-backed deployment with auth, permissions, federation, and multi-tenant isolation. No code changes. How it works **Kernel** never changes. **Drivers** swap at config time. **Bricks** mount and unmount at runtime — like / for an AI filesystem. Get started in 30 seconds Option A: Docker (recommended) Open . That's it. Option B: Embedded (no Docker) Option C: CLI Terminal UI The TUI is a separate TypeScript package built on OpenTUI: File explorer, API inspector, monitoring dashboard, agent lifecycle management, and more — all from your terminal. What you get | Capability | What it does | How agents use it | |---|---|---| | **Filesystem** | POSIX-style read/write/mkdir/ls with CAS dedup | Shared workspace — no more temp files | | **Versioning** | Every write creates an immutable version | Rollback mistakes, diff changes, audit trails | | **Snapshots** | Atomic multi-file transactions | Commit or rollback a batch of changes together | | **Search** | Keyword + semantic + hybrid, powered by Zoekt + pgvector | Find anything by content or meaning | | **Memory** | Persistent agent memory with consolidation + versioning | Remember across runs and sessions | | **Delegation** | SSH-style agent-to-agent permission narrowing | Safely sub-delegate work with scoped access | | **ReBAC** | Relationship-based access control (Google Zanzibar model) | Fine-grained per-file, per-agent permissions | | **MCP** | Mount external MCP servers, expose Nexus as 30+ MCP tools | Bridge any tool ecosystem | | **Workflows** | Trigger → condition → action pipelines | Automate file processing, notifications, etc. | | **Governance** | Fraud detection, collusion rings, trust scores | Safety rails for autonomous agent fleets | | **Pay** | Credit ledger with reserves, policies, approvals | Metered compute for multi-tenant deployments | | **IPC** | Inbox-based inter-agent messaging via pipes | Agents talk to each other without polling | | **Federation** | Multi-zone Raft consensus with mTLS TOFU | Span data centers without a central coordinator | All bricks and system services → **Bricks (runtime-loadable):** Access Manifests · Auth (API key, OAuth, mTLS) · Catalog (schema extraction) · Context Manifests · Delegation · Discovery · Identity (DID + credentials) · IPC (pipes) · MCP · Mount · Parsers (50+ formats via MarkItDown) · Pay · Portability (import/export) · ReBAC · Sandbox (Docker) · Search · Share Links (capability URLs) · Snapshots · Task Manager · TUS Uploads (resumable) · Versioning · Workflows · Workspace **System services:** Agent Registry · Agent Runtime · Event Bus · Event Log · Namespace · Scheduler (fair-share, priority tiers) · Sync · Lifecycle Framework integrations Every major agent framework works out of the box: | Framework | What the example shows | Link | |---|---|---| | **Claude Agent SDK** | ReAct agent with Nexus as tool provider | examples/claude_agent_sdk/ | | **OpenAI Agents** | Multi-tenant agents with shared memory | examples/openai_agents/ | | **LangGraph** | Permission-scoped workflows | examples/langgraph_integration/ | | **CrewAI** | Multi-agent collaboration on shared files | examples/crewai/ | | **Google ADK** | Agent Development Kit integration | examples/google_adk/ | | **E2B** | Cloud sandbox execution | examples/e2b/ | | **CLI** | 40+ shell demos covering every feature | examples/cli/ | Deployment options | Mode | What | Who it's for | |---|---|---| | **Embedded** | — in-process, zero infrastructure | Scripts, notebooks, single-agent apps | | **Shared daemon** | | Teams, multi-agent systems, staging | | **Federation** | Multi-zone Raft consensus across data centers | Production fleets, edge deployments | presets | Preset | Services | Auth | Use case | |---|---|---|---| | | None (embedded) | None | Single-process scripts, notebooks | | | Nexus + Postgres + Dragonfly + Zoekt | Static API key | Team dev, multi-agent staging | | | Same as shared | Database-backed | Demos, seed data, evaluation | Docker image Published to GHCR (multi-arch: amd64 + arm64): Storage architecture Four pillars, separated by access pattern — not by domain: | Pillar | Interface | Capability | Required? | |---|---|---|---| | **Metastore** | | Ordered KV, CAS, prefix scan, optional Raft | Yes — sole kernel init param | | **ObjectStore** | | Streaming blob I/O, petabyte scale | Mounted dynamically | | **RecordStore** | | Relational ACID, JOINs, vector search | Services only — optional | | **CacheStore** | | Ephemeral KV, pub/sub, TTL | Optional (defaults to null) | The kernel starts with just a Metastore. Everything else is layered on without changing a line of kernel code. Contributing For semantic search work: For Rust extensions: See CONTRIBUTING.md for the full guide. Troubleshooting ModuleNotFoundError: No module named 'nexus' Install from PyPI: . The package name on PyPI is , not . maturin develop fails at the repo root Point maturin at a crate manifest: faiss-cpu resolution fails Only install semantic search extras on platforms with compatible / wheels: License Apache License 2.0 — see LICENSE for details. Built by Nexi Labs.