Recursos

Todo lo que rodea al producto en lugar de estar dentro de él: cómo conseguir ayuda, cómo contribuir y cómo extender la plataforma.

Ayuda a AgenticOS

El proyecto es joven y la forma más rápida de ayudarlo es usarlo y contar qué se ha roto.

• Informa de un fallo

  Qué se rompe, la secuencia que lo provoca y cómo sabrías que está arreglado. Esa tercera parte es la que le falta a la mayoría de los issues.

• Sugiere algo

  Mira antes el mapa de issues: dice qué está ya planificado y qué no tiene aún alcance definido.

• Dale una estrella al repositorio

  Es la señal más barata de que vale la pena seguir con esto.

Desarrollo — contribuir

Lee la página que corresponda a lo que estés tocando. Son las propias notas de ingeniería del repositorio, publicadas en lugar de reescritas, así que lo que lees es lo que leen quienes contribuyen.

Si trabajas en	Lee
Cualquier cosa, lo primero	Arquitectura · El código de la consola — rutas → servicios → repositorios, y la transacción de la petición
Una forma que ya has visto antes	Patrones
Una funcionalidad, de principio a fin	Añadir funcionalidades
Un test, o un coverage gate en rojo	Tests
Una pull request	Revisión de código y Ramas

Tres cosas que te van a morder

Un repositorio confirma con db.flush(), nunca con db.commit(). El trabajo en segundo plano que lee una fila que la petición acaba de escribir se entrega con spawn_after_commit, nunca con spawn. Y la capa de plataforma se mantiene al 100 % de cobertura, impuesto en CI. Las tres están en Arquitectura y Tests, y en las tres se ha metido la pata aquí al menos una vez.

Extender la plataforma

Ampliar lo que el propio AgenticOS sabe hacer, en Python. Son recetas para quien contribuye: necesitas el repositorio clonado.

• Añade una capability — una herramienta nueva que el modelo puede llamar
• Añade un servidor al catálogo MCP
• Añade un endpoint de la API
• Añade una tarea en segundo plano
• Añade un conector de sincronización

Antes de escribir una capability

Pregúntate si en realidad no es una conexión MCP. Una capability que sería un cliente de la API de un único producto SaaS es un servidor que alguien ya ha escrito, y traerlo a este repositorio significa mantenerlo contra la API de ese producto para siempre.

Construido sobre

AgenticOS se genera a partir de Full-Stack AI Agent Template, y se apoya en:

• Pydantic AI — el runtime del agent
• FastAPI y Pydantic — el backend
• pgvector — la recuperación
• Prefect — el trabajo en segundo plano
• Next.js — la consola
• Model Context Protocol — todas las integraciones

Licencia

Apache 2.0. Consulta LICENSE.