Metadata-Version: 2.4
Name: openagno
Version: 1.2.0
Summary: Build autonomous AI agents with declarative YAML configuration
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: agno[os,scheduler]>=1.5.0
Requires-Dist: aioboto3>=13.0
Requires-Dist: anthropic>=0.30.0
Requires-Dist: arxiv>=2.0.0
Requires-Dist: boto3>=1.35
Requires-Dist: crawl4ai>=0.4.0
Requires-Dist: chardet<6,>=5.2
Requires-Dist: ddgs>=6.0
Requires-Dist: duckduckgo-search>=6.0
Requires-Dist: fastapi>=0.110.0
Requires-Dist: fastmcp>=2.0.0
Requires-Dist: google-genai>=1.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: mistralai>=1.0.0
Requires-Dist: openai>=1.30.0
Requires-Dist: pgvector>=0.3
Requires-Dist: psycopg[binary]>=3.1
Requires-Dist: PyGithub>=2.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: python-multipart>=0.0.9
Requires-Dist: pyyaml>=6.0
Requires-Dist: pyTelegramBotAPI>=4.32.0
Requires-Dist: rich>=13.0
Requires-Dist: slack-sdk>=3.41.0
Requires-Dist: slowapi>=0.1.9
Requires-Dist: sqlalchemy>=2.0
Requires-Dist: tavily-python>=0.4.0
Requires-Dist: typer>=0.12.0
Requires-Dist: uvicorn>=0.27.0
Requires-Dist: wikipedia>=1.4.0
Requires-Dist: wsproto>=1.3.0
Requires-Dist: yfinance>=0.2.0
Provides-Extra: dev
Requires-Dist: build>=1.2.2; extra == "dev"
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: twine>=5.1.1; extra == "dev"
Provides-Extra: protocols
Requires-Dist: a2a-sdk>=0.3.25; extra == "protocols"
Requires-Dist: ag-ui-protocol>=0.1.14; extra == "protocols"
Dynamic: license-file

# OpenAgno

OpenAgno is a declarative agent platform built on **Agno**. It packages a CLI, an AgentOS/FastAPI runtime, reusable workspace templates, MCP support, channel integrations, vector knowledge with PgVector, and a new tenant-aware provisioning layer for multi-tenant deployments.

OpenAgno es una plataforma declarativa para agentes construida sobre **Agno**. Incluye una CLI empaquetada, runtime AgentOS/FastAPI, templates reutilizables, soporte MCP, canales, knowledge vectorial con PgVector y una nueva capa tenant-aware para despliegues multi-tenant.

## English

### What exists today

- packaged CLI: `openagno`
- declarative `workspace/` with YAML + Markdown
- AgentOS runtime with admin, knowledge, and channel routes
- packaged templates for common assistants
- WhatsApp, Slack, Telegram, AG-UI, and A2A support
- PgVector-backed knowledge on PostgreSQL or Supabase
- public docs with MCP and `llms.txt`
- tenant provisioning routes and tenant-scoped agent runs

### Installation

If `openagno` is already available in your Python index, use:

```bash
pip install openagno
```

If not, install from source:

```bash
git clone https://github.com/israelgo93/OpenAgno.git
cd OpenAgno
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
```

For contributors, package builds, tests, and protocol extras:

```bash
pip install -e '.[dev,protocols]'
```

### Quickstart

```bash
openagno templates list
openagno init --template personal_assistant
openagno validate
openagno start --foreground
```

Health check:

```bash
curl http://127.0.0.1:8000/admin/health
```

### Tenant provisioning

OpenAgno now includes tenant-aware routes:

- `POST /tenants`
- `GET /tenants/{tenant_id}`
- `PUT /tenants/{tenant_id}/workspace`
- `POST /tenants/{tenant_id}/agents/{agent_id}/runs`

The runtime uses Agno-native isolation with `Knowledge(..., isolate_vector_search=True)` and `knowledge_filters={"linked_to": "<tenant>"}`.

### IDE and AI integration

- MCP: `https://docs.openagno.com/mcp`
- `llms.txt`: `https://docs.openagno.com/llms.txt`
- config exports: [`ide-configs/cursor-mcp.json`](/home/ubuntu/Proyectos/OpenAgno/ide-configs/cursor-mcp.json), [`ide-configs/vscode-mcp.json`](/home/ubuntu/Proyectos/OpenAgno/ide-configs/vscode-mcp.json), [`ide-configs/windsurf-mcp.json`](/home/ubuntu/Proyectos/OpenAgno/ide-configs/windsurf-mcp.json)
- project skill: [`SKILL.md`](/home/ubuntu/Proyectos/OpenAgno/.agents/skills/openagno/SKILL.md)

### Repo structure

```text
OpenAgno/
  openagno/            # CLI, templates, and core helpers
  workspace/           # Declarative runtime configuration
  gateway.py           # Runtime entrypoint
  loader.py            # Workspace and Agno object builder
  routes/              # Custom REST routes
  tests/               # Regression suite
  docs/                # Mintlify docs site
  ide-configs/         # MCP export templates for IDEs
```

## Español

### Qué existe hoy

- CLI empaquetada: `openagno`
- `workspace/` declarativo en YAML + Markdown
- runtime AgentOS con rutas admin, knowledge y canales
- templates empaquetados para asistentes comunes
- soporte para WhatsApp, Slack, Telegram, AG-UI y A2A
- knowledge con PgVector sobre PostgreSQL o Supabase
- documentación pública con MCP y `llms.txt`
- rutas de provisioning tenant-aware y ejecuciones por tenant

### Instalación

Si `openagno` ya existe en tu índice Python, usa:

```bash
pip install openagno
```

Si todavía no aparece en tu índice o mirror, instala desde el repositorio:

```bash
git clone https://github.com/israelgo93/OpenAgno.git
cd OpenAgno
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
```

Para contributors, builds, tests y extras de protocolos:

```bash
pip install -e '.[dev,protocols]'
```

### Inicio rápido

```bash
openagno templates list
openagno init --template personal_assistant
openagno validate
openagno start --foreground
```

Chequeo de salud:

```bash
curl http://127.0.0.1:8000/admin/health
```

### Aprovisionamiento multi-tenant

OpenAgno ahora incluye rutas tenant-aware:

- `POST /tenants`
- `GET /tenants/{tenant_id}`
- `PUT /tenants/{tenant_id}/workspace`
- `POST /tenants/{tenant_id}/agents/{agent_id}/runs`

El runtime usa aislamiento nativo de Agno con `Knowledge(..., isolate_vector_search=True)` y `knowledge_filters={"linked_to": "<tenant>"}`.

### Integración con IDEs y asistentes

- MCP: `https://docs.openagno.com/mcp`
- `llms.txt`: `https://docs.openagno.com/llms.txt`
- exports en `ide-configs/`
- skill local en `.agents/skills/openagno/SKILL.md`

## Docs

Local preview:

```bash
cd docs
npm install
npm run dev
```

Broken links:

```bash
cd docs
npm run broken-links
```

## License

Apache 2.0.
