felix

Felix é um framework de agentes auto-hospedável. Os agentes são autorados como manifestos YAML usando apiVersion felix/v1; o projeto os compila em agentes governados com fibras duráveis, memória, habilidades, avaliação, aprovações e sandboxes. Ele expõe esses agentes por meio de REST/SSE, uma API compatível com OpenAI /v1, A2A JSON-RPC e MCP, e fornece APIs de gerenciamento para auditoria, aprovações, planos, trabalhos, manifestos, avaliação, uso e memória. Execuções ao vivo podem ser bifurcadas, rebobinadas e direcionadas, com estratégias de sessão para compactação, janelas ou contextos semânticos. A stack inclui um serviço de API, um worker e um scheduler. Postgres com pgvector é o sistema de registro, com Valkey como cache e um armazenamento de objetos que pode ser filesystem, S3 ou GCS. Backends opcionais de analytics warehouse incluem DuckDB, ClickHouse e Doris. Opções de deploy incluem Docker Compose, Helm, AWS e GCP, com uma imagem padrão enxuta e extras opcionais para SDKs cloud, observabilidade e suporte a warehouse. Recursos de governança cobrem autenticação, aprovações, trilhas de auditoria, medidores de uso e controles de retenção. Observabilidade usa métricas Prometheus e OpenTelemetry; chamadas de modelo seguem convenções semânticas GenAI. Provedores de modelo incluem Anthropic, OpenAI, Ollama, Workers AI e vários fornecedores compatíveis com OpenAI, com IDs lógicos de modelo mapeados por configuração. O catálogo de modelos contém janela de contexto, saída máxima, preço, parâmetros, suporte a thinking e modalidades por família. Felix é projetado para extensão em vez de ditar fluxos de trabalho. Plugins podem registrar ferramentas, rotas HTTP, tarefas cron, modos de auth, chaves de rate-limit, limites de corpo, mounts autoautenticáveis, hooks de inicialização, sinks de auditoria/usos e hooks de loop de agente. Registros abertos permitem selecionar patterns, provedores de modelo, armazenamentos de objetos, backends de secrets, backends de warehouse, backends de embedder, backends de busca, estratégias de sessão e checkpointers por meio de configuração. Agent Skills podem ser adicionados como arquivos SKILL.md sem código. O repositório inclui manifestos embutidos como quick, deep, router, oss-only, hybrid-router, support, cowork, governed e contributor. Um quick start copia .env.example, executa make install e make up, então usa a key de API local gerada contra /chat ou o endpoint compatível com OpenAI. O projeto afirma executar em infraestrutura controlada pelo operador e é agnóstico a serviços e cloud, usando Protocols ao invés de um único SDK de vendor.