evo-ai-processor-community¶

Python 3.10+ / FastAPI · porta 8000

Microserviço de orquestração de agentes de IA — workflows entre múltiplos agentes, sessões, busca/armazenamento vetorial e integração com serviços de IA modernos.

Tecnologias¶

FastAPI, SQLAlchemy (ORM), Pydantic (validação), Uvicorn (ASGI), Redis (cache/filas), JWT (python-jose/pyjwt), Pinecone/Qdrant/OpenSearch (vetorial), OpenAI (embeddings opcional), Google ADK, LangGraph (orquestração de workflows entre agentes), MinIO (artefatos), OpenTelemetry (observabilidade), a2a-sdk/mcp, Alembic (migrações).

Estrutura (Domain-Driven + Layered)¶

src/
├── main.py                 # entrypoint
├── api/v1/[resource]/       # routers FastAPI
├── services/[domain]/       # lógica de negócio
├── models/                   # modelos SQLAlchemy
├── schemas/                  # DTOs Pydantic
├── core/                     # config centralizada
├── middleware/
└── utils/

migrations/                   # Alembic (env.py, versions/)
tests/
├── unit/, integration/

Padrões¶

Validação de DTO via Pydantic; injeção de dependência via FastAPI; I/O sempre async/await; JWT Bearer.

Build & testes¶

cd evo-ai-processor-community
uv sync
uv run python -m alembic upgrade head
uv run uvicorn src.main:app
uv run pytest tests/unit/
uv run pytest tests/integration/
uv run ruff check .