Visão Geral

Visão Geral

Construa agentes de IA confiáveis e auto-aperfeiçoáveis sem codificar fluxos de trabalho. Defina seu objetivo através de uma conversa com um agente de codificação, e o framework gera um grafo de nós com código de conexão criado dinamicamente. Quando algo quebra, o framework captura dados de falha, evolui o agente através do agente de codificação e reimplanta. Nós de intervenção humana integrados, gerenciamento de credenciais e monitoramento em tempo real dão a você controle sem sacrificar a adaptabilidade.

Visite adenhq.com para documentação completa, exemplos e guias.

O que é Aden

Aden é uma plataforma para construir, implantar, operar e adaptar agentes de IA:

• Construir - Um Agente de Codificação gera Agentes de Trabalho especializados (Vendas, Marketing, Operações) a partir de objetivos em linguagem natural
• Implantar - Implantação headless com integração CI/CD e gerenciamento completo do ciclo de vida de API
• Operar - Monitoramento em tempo real, observabilidade e guardrails de runtime mantêm os agentes confiáveis
• Adaptar - Avaliação contínua, supervisão e adaptação garantem que os agentes melhorem ao longo do tempo
• Infraestrutura - Memória compartilhada, integrações LLM, ferramentas e habilidades alimentam cada agente

Links Rápidos

• Documentação - Guias completos e referência de API
• Guia de Auto-Hospedagem - Implante o Hive em sua infraestrutura
• Changelog - Últimas atualizações e versões

• Reportar Problemas - Relatórios de bugs e solicitações de funcionalidades

Início Rápido

Pré-requisitos

• Python 3.11+ - Para desenvolvimento de agentes
• Docker (v20.10+) - Opcional, para ferramentas containerizadas

Instalação

# Clonar o repositório
git clone https://github.com/adenhq/hive.git
cd hive

# Executar configuração do ambiente Python
./quickstart.sh

Isto instala:

• framework - Runtime do agente principal e executor de grafos
• aden_tools - 19 ferramentas MCP para capacidades de agentes
• Todas as dependências necessárias

Construa Seu Primeiro Agente

# Instalar habilidades do Claude Code (uma vez)
./quickstart.sh

# Construir um agente usando Claude Code
claude> /hive

# Testar seu agente
claude> /hive-test

# Executar seu agente
PYTHONPATH=exports uv run python -m your_agent_name run --input '{...}'

📖 Guia Completo de Configuração - Instruções detalhadas para desenvolvimento de agentes

Funcionalidades

• Desenvolvimento Orientado a Objetivos - Defina objetivos em linguagem natural; o agente de codificação gera o grafo de agentes e código de conexão para alcançá-los
• Agentes Auto-Adaptáveis - Framework captura falhas, atualiza objetivos e atualiza o grafo de agentes
• Conexões de Nós Dinâmicas - Sem arestas predefinidas; código de conexão é gerado por qualquer LLM capaz baseado em seus objetivos
• Nós Envolvidos em SDK - Cada nó recebe memória compartilhada, memória RLM local, monitoramento, ferramentas e acesso LLM prontos para uso
• Humano no Loop - Nós de intervenção que pausam a execução para entrada humana com timeouts e escalonamento configuráveis
• Observabilidade em Tempo Real - Streaming WebSocket para monitoramento ao vivo de execução de agentes, decisões e comunicação entre nós
• Controle de Custo e Orçamento - Defina limites de gastos, throttles e políticas de degradação automática de modelo
• Pronto para Produção - Auto-hospedável, construído para escala e confiabilidade

Por que Aden

Frameworks de agentes tradicionais exigem que você projete manualmente fluxos de trabalho, defina interações de agentes e lide com falhas reativamente. Aden inverte esse paradigma—você descreve resultados, e o sistema se constrói sozinho.

flowchart LR
    subgraph BUILD["🏗️ BUILD"]
        GOAL["Define Goal<br/>+ Success Criteria"] --> NODES["Add Nodes<br/>LLM/Router/Function"]
        NODES --> EDGES["Connect Edges<br/>on_success/failure/conditional"]
        EDGES --> TEST["Test & Validate"] --> APPROVE["Approve & Export"]
    end

    subgraph EXPORT["📦 EXPORT"]
        direction TB
        JSON["agent.json<br/>(GraphSpec)"]
        TOOLS["tools.py<br/>(Functions)"]
        MCP["mcp_servers.json<br/>(Integrations)"]
    end

    subgraph RUN["🚀 RUNTIME"]
        LOAD["AgentRunner<br/>Load + Parse"] --> SETUP["Setup Runtime<br/>+ ToolRegistry"]
        SETUP --> EXEC["GraphExecutor<br/>Execute Nodes"]

        subgraph DECISION["Decision Recording"]
            DEC1["runtime.decide()<br/>intent → options → choice"]
            DEC2["runtime.record_outcome()<br/>success, result, metrics"]
        end
    end

    subgraph INFRA["⚙️ INFRASTRUCTURE"]
        CTX["NodeContext<br/>memory • llm • tools"]
        STORE[("FileStorage<br/>Runs & Decisions")]
    end

    APPROVE --> EXPORT
    EXPORT --> LOAD
    EXEC --> DECISION
    EXEC --> CTX
    DECISION --> STORE
    STORE -.->|"Analyze & Improve"| NODES

    style BUILD fill:#ffbe42,stroke:#cc5d00,stroke-width:3px,color:#333
    style EXPORT fill:#fff59d,stroke:#ed8c00,stroke-width:2px,color:#333
    style RUN fill:#ffb100,stroke:#cc5d00,stroke-width:3px,color:#333
    style DECISION fill:#ffcc80,stroke:#ed8c00,stroke-width:2px,color:#333
    style INFRA fill:#e8763d,stroke:#cc5d00,stroke-width:3px,color:#fff
    style STORE fill:#ed8c00,stroke:#cc5d00,stroke-width:2px,color:#fff

A Vantagem Aden

Como Funciona

1. Defina Seu Objetivo → Descreva o que você quer alcançar em linguagem simples
2. Agente de Codificação Gera → Cria o grafo de agentes, código de conexão e casos de teste
3. Workers Executam → Nós envolvidos em SDK executam com observabilidade completa e acesso a ferramentas
4. Plano de Controle Monitora → Métricas em tempo real, aplicação de orçamento, gerenciamento de políticas
5. Auto-Aperfeiçoamento → Em caso de falha, o sistema evolui o grafo e reimplanta automaticamente

Como Aden se Compara

Aden adota uma abordagem fundamentalmente diferente para o desenvolvimento de agentes. Enquanto a maioria dos frameworks exige que você codifique fluxos de trabalho ou defina manualmente grafos de agentes, Aden usa um agente de codificação para gerar todo o seu sistema de agentes a partir de objetivos em linguagem natural. Quando os agentes falham, o framework não apenas registra erros—ele evolui automaticamente o grafo de agentes e reimplanta.

Nota: Para a tabela de comparação detalhada de frameworks e perguntas frequentes, consulte o README.md em inglês.

Quando Escolher Aden

Escolha Aden quando você precisar de:

• Agentes que se auto-aperfeiçoam a partir de falhas sem intervenção manual
• Desenvolvimento orientado a objetivos onde você descreve resultados, não fluxos de trabalho
• Confiabilidade em produção com recuperação e reimplantação automáticas
• Iteração rápida em arquiteturas de agentes sem reescrever código
• Observabilidade completa com monitoramento em tempo real e supervisão humana

Escolha outros frameworks quando você precisar de:

• Fluxos de trabalho previsíveis e type-safe (PydanticAI, Mastra)
• RAG e processamento de documentos (LlamaIndex, Haystack)
• Pesquisa sobre emergência de agentes (CAMEL)
• Voz/multimodal em tempo real (TEN Framework)
• Encadeamento simples de componentes (LangChain, Swarm)

Estrutura do Projeto

hive/
├── core/                   # Framework principal - Runtime de agentes, executor de grafos, protocolos
├── tools/                  # Pacote de Ferramentas MCP - 19 ferramentas para capacidades de agentes
├── exports/                # Pacotes de Agentes - Agentes pré-construídos e exemplos
├── docs/                   # Documentação e guias
├── scripts/                # Scripts de build e utilitários
├── .claude/                # Habilidades Claude Code para construir agentes
├── CONTRIBUTING.md         # Diretrizes de contribuição

Desenvolvimento

Desenvolvimento de Agentes Python

Para construir e executar agentes orientados a objetivos com o framework:

# Configuração única
./quickstart.sh

# Isto instala:
# - pacote framework (runtime principal)
# - pacote aden_tools (19 ferramentas MCP)
# - Todas as dependências

# Construir novos agentes usando habilidades Claude Code
claude> /hive

# Testar agentes
claude> /hive-test

# Executar agentes
PYTHONPATH=exports uv run python -m agent_name run --input '{...}'

Consulte environment-setup.md para instruções completas de configuração.

Documentação

• Guia do Desenvolvedor - Guia abrangente para desenvolvedores
• Começando - Instruções de configuração rápida
• Guia de Configuração - Todas as opções de configuração
• Visão Geral da Arquitetura - Design e estrutura do sistema

Roadmap

O Aden Agent Framework visa ajudar desenvolvedores a construir agentes auto-adaptativos orientados a resultados. Encontre nosso roadmap aqui

roadmap.md

timeline
    title Aden Agent Framework Roadmap
    section Foundation
        Architecture : Node-Based Architecture : Python SDK : LLM Integration (OpenAI, Anthropic, Google) : Communication Protocol
        Coding Agent : Goal Creation Session : Worker Agent Creation : MCP Tools Integration
        Worker Agent : Human-in-the-Loop : Callback Handlers : Intervention Points : Streaming Interface
        Tools : File Use : Memory (STM/LTM) : Web Search : Web Scraper : Audit Trail
        Core : Eval System : Pydantic Validation : Docker Deployment : Documentation : Sample Agents
    section Expansion
        Intelligence : Guardrails : Streaming Mode : Semantic Search
        Platform : JavaScript SDK : Custom Tool Integrator : Credential Store
        Deployment : Self-Hosted : Cloud Services : CI/CD Pipeline
        Templates : Sales Agent : Marketing Agent : Analytics Agent : Training Agent : Smart Form Agent

Comunidade e Suporte

Usamos Discord para suporte, solicitações de funcionalidades e discussões da comunidade.

• Discord - Junte-se à nossa comunidade
• Twitter/X - @adenhq
• LinkedIn - Página da Empresa

Contribuindo

Aceitamos contribuições! Por favor, consulte CONTRIBUTING.md para diretrizes.

Importante: Por favor, seja atribuído a uma issue antes de enviar um PR. Comente na issue para reivindicá-la e um mantenedor irá atribuí-la a você em 24 horas. Isso ajuda a evitar trabalho duplicado.

1. Encontre ou crie uma issue e seja atribuído
2. Faça fork do repositório
3. Crie sua branch de funcionalidade (git checkout -b feature/amazing-feature)
4. Faça commit das suas alterações (git commit -m 'Add amazing feature')
5. Faça push para a branch (git push origin feature/amazing-feature)
6. Abra um Pull Request

Junte-se ao Nosso Time

Estamos contratando! Junte-se a nós em funções de engenharia, pesquisa e go-to-market.

Ver Posições Abertas

Segurança

Para questões de segurança, por favor consulte SECURITY.md.

Licença

Este projeto está licenciado sob a Licença Apache 2.0 - veja o arquivo LICENSE para detalhes.

Perguntas Frequentes (FAQ)

Nota: Para as perguntas frequentes completas, consulte o README.md em inglês.

P: O Aden depende do LangChain ou outros frameworks de agentes?

Não. O Aden é construído do zero sem dependências do LangChain, CrewAI ou outros frameworks de agentes. O framework é projetado para ser leve e flexível, gerando grafos de agentes dinamicamente em vez de depender de componentes predefinidos.

P: Quais provedores de LLM o Aden suporta?

O Aden suporta mais de 100 provedores de LLM através da integração LiteLLM, incluindo OpenAI (GPT-4, GPT-4o), Anthropic (modelos Claude), Google Gemini, Mistral, Groq e muitos mais. Simplesmente configure a variável de ambiente da chave API apropriada e especifique o nome do modelo.

P: O Aden é open-source?

Sim, o Aden é totalmente open-source sob a Licença Apache 2.0. Incentivamos ativamente contribuições e colaboração da comunidade.

P: O que torna o Aden diferente de outros frameworks de agentes?

O Aden gera todo o seu sistema de agentes a partir de objetivos em linguagem natural usando um agente de codificação—você não codifica fluxos de trabalho nem define grafos manualmente. Quando os agentes falham, o framework captura automaticamente os dados de falha, evolui o grafo de agentes e reimplanta. Este loop de auto-aperfeiçoamento é único do Aden.

P: O Aden suporta fluxos de trabalho com humano no loop?

Sim, o Aden suporta totalmente fluxos de trabalho com humano no loop através de nós de intervenção que pausam a execução para entrada humana. Estes incluem timeouts configuráveis e políticas de escalonamento, permitindo colaboração perfeita entre especialistas humanos e agentes de IA.