Saltar a contenido

Ciel — Framework enterprise de agentes autónomos

Tagline

Ciel es un framework de agentes enterprise para Python (>=3.11): multi-tenant, model-agnostic y deploy-agnostic. Construye agentes autónomos y sistemas multi-agente con trazabilidad nativa, adapters de canal funcionales y una API de alto nivel de pocas líneas.

Distribuido en PyPI como mana-ciel (el import y el CLI se mantienen como ciel):

uv add mana-ciel      # o: pip install mana-ciel
ciel --help

Tu primer agente en ~15 líneas

import ciel

@ciel.tool
def add(a: int, b: int) -> int:
    "Suma dos enteros."
    return a + b

# Provider offline de ejemplo (sustitúyelo por OpenAI/Anthropic/Gemini)
from ciel.providers import OpenAICompatibleProvider
provider = OpenAICompatibleProvider(base_url="https://api.openai.com/v1",
                                   api_key="sk-...", default_model="gpt-4o")

agent = ciel.Agent(provider=provider, tools=[add], model="gpt-4o")
resp = agent.run("¿Cuánto es 2 + 3?", tenant_id="acme")
print(resp.text)

¿Sin API key a mano? El Inicio rápido incluye un DummyProvider 100% offline que puedes ejecutar ya mismo.

Características principales

  • Multi-tenancy nativo

Aislamiento, trazabilidad y cuotas por inquilino. El tenant_id fluye desde Agent.run() hasta cada tool vía Context. Multi-tenancy

  • API de alto nivel

@ciel.tool, ciel.Agent, ciel.Context y AgentResponse. Inferencia de esquema JSON desde type hints + docstring (Pydantic v2). Inicio rápido

  • Model-agnostic

Providers incluidos para OpenAI-compatible, Anthropic y Gemini. Crea el tuyo subclassando ChatProvider. Providers

  • Tools con inyección de dependencias

Declara un parámetro Context y Ciel lo inyecta y lo excluye del esquema. Tools síncronas o async. Tools

  • Seguridad y HITL

Políticas de aprobación, redacción de secretos/PII y pausas Human-in-the-Loop sobre grafos de estado. Security

  • Observabilidad

Auditoría multi-tenant y trazas de tool execution listas para exportar. Observability

  • Ciel Studio (v0.7)

Dashboard offline-safe de sesiones, loops, trazas con replay y coste. Ciel Studio

  • Escala y HA real (v0.8)

StateBackend compartido, health checks /healthz y /readyz, y resume con lease anti-doble-ejecución para N réplicas. Despliegue

  • Enterprise reforzado (v0.9)

SSO/OIDC con proveedor real (JWKS), Vault de secretos dinámicos con rotación, y guardrails + sandbox de ejecución de código (Docker/gVisor). Seguridad

  • Providers y multimodal (v0.10)

Multimodal nativo (text/image_url/input_audio), meta-provider LiteLLM (100+ modelos), Azure OpenAI, Ollama local y vLLM/TGI vía prefijos en auto_provider (azure/, ollama/, vllm/). Providers

Documentación

  • Guía

Empieza por el Inicio rápido y los Conceptos centrales. Ir a la Guía

  • Arquitectura

Diseño de multi-tenancy, runtime, dispatcher y gateway. Ver arquitectura

  • Runbooks (ops)

Despliegue, incidentes, rollback, backup y HPA. Ver runbooks

  • Referencia de API

Módulos públicos generados con mkdocstrings: CLI, runtime, providers, gateway, security. Índice de la API

Estado del proyecto
PyPI mana-ciel (import ciel)
Compatibilidad Python >= 3.11
Versión actual 0.10.0 — Providers y multimodal (multimodal nativo, meta-provider LiteLLM, Azure OpenAI, Ollama local, vLLM/TGI vía prefijos en auto_provider)
Repositorio https://github.com/Ander-Labs/ciel-agent-framework
Releases https://github.com/Ander-Labs/ciel-agent-framework/releases
Licencia AGPL-3.0-or-later (dual comercial disponible)

¿Vienes de una versión anterior? Revisa la guía de upgrade.