nexus-enterprise-agent 0.1.0

Enterprise-ready, SaaS-native Python multi-agent framework

Nexus

Enterprise-ready agent framework. Describe agents in config. Wire who is calling and where data lives at run time. Call run().

No global LLM settings. No shared agent singleton. Built for multi-tenant SaaS apps.

---

Install

From PyPI:

pip install nexus-enterprise-agent

With optional extras (storage, LLM providers, FastAPI):

pip install "nexus-enterprise-agent[sqlite,litellm,fastapi]"

From GitHub:

pip install "git+https://github.com/gowrav-vishwakarma/nexus-saas-agent-framework.git"

For local development, clone the repo and sync dependencies:

uv sync --extra dev --extra sqlite --extra file

For the SaaS API example:

uv sync --extra fastapi --extra sqlite --extra litellm

Copy .env.example to .env and set your LLM API key.

Run tests:

uv run pytest

---

Run in 3 steps

Step	File	Purpose
1	team.yaml	What agents exist and how they connect
2	team_prompts.py	How they speak (prompt templates)
3	Short Python script	Who is calling (tenant, user, chat id)

The repo includes a working team at examples/orchestration/.

uv run python examples/orchestration/run_team.py "Analyze Q4 revenue"

---

Minimal example

import asyncio
from nexus import OrchestrationManifest, OrchestrationRuntime, RunContext

async def main():
    manifest = OrchestrationManifest.load("examples/orchestration/research_team.yaml")
    runtime = OrchestrationRuntime.from_manifest(
        manifest,
        run_context=RunContext(
            tenant_id="demo",
            user_id="user-1",
            session_id="chat-1",  # set before building runtime for teams
        ),
    )
    result = await runtime.run("Analyze Q4 revenue")
    print(result.final_response)

asyncio.run(main())

Every parameter (optional fields and defaults) is documented in docs/assets/complete-manifest.annotated.yaml and docs/assets/complete-run.annotated.py.

---

Learn more

Full documentation: docs/index.md

Topic	Doc
Architecture (what goes where)	docs/architecture.md
YAML walkthrough	docs/getting-started.md
Python API walkthrough	docs/getting-started-python.md
All YAML fields + defaults	docs/reference/manifest-schema.md
Memory (cross-session facts)	docs/reference/memory.md
Context summary (long chats)	docs/reference/context-summary.md
Multi-tenant SaaS example	docs/guides/saas-example.md
Example index	docs/examples.md
Full design spec	NEXUS_AGENT_PRD.md

---

Examples

• examples/orchestration/ — YAML multi-agent team
• examples/nexus_saas_api.py — FastAPI SaaS API with plan tiers

uv run uvicorn examples.nexus_saas_api:app --host 0.0.0.0 --port 8000