aa1143/NamiAgent

O que é?

Recursos principais

• 01Ensina a criar um agente passo a passo em 11 lições, cada uma com uma versão executável do código
• 02Oferece ferramentas, confirmação de permissões, compactação de contexto e persistência de sessões
• 03Inclui suporte a cliente MCP via stdio e subagentes com contexto independente
• 04A interface no navegador mostra cada chamada ao modelo, chamada de ferramenta e o contexto completo de cada turno
• 05Usa qualquer API compatível com a OpenAI, com DeepSeek como padrão, e tem apenas o pacote `openai` como dependência
• 06A partir da lição 3, inclui testes que podem ser executados sem uma API key

Casos de uso

• Aprender desde o início como funcionam os loops de agentes, as ferramentas e o gerenciamento de contexto
• Acompanhar o código junto com as lições e comparar etapas consecutivas
• Executar um pequeno agente local em um workspace dedicado, com solicitações de confirmação
• Estudar a estrutura de agentes comerciais de programação por meio das análises incluídas

Início rápido

1. 1

   Clone o repositório

   git clone https://github.com/aa1143/NamiAgent.git
2. 2

   Acesse o projeto e instale as dependências

   cd NamiAgent && pip install -r requirements.txt
3. 3

   Configure a chave de API do modelo e crie o workspace

   export API_KEY=你的模型密钥 && export NAMI_WORKSPACE=~/agent-workspace && mkdir -p $NAMI_WORKSPACE
4. 4

   Execute o agente da lição 5

   cd lessons/lesson-05 && python agent.py

Antes de usar

• !É necessária uma chave de API do modelo; o padrão é DeepSeek.
• !O agente pode executar comandos e ler ou gravar arquivos, por isso deve ser executado em um workspace dedicado.
• !Este é um projeto educacional, não um framework de agentes pronto para produção.
• !A documentação em docs/ está licenciada sob CC BY-NC 4.0, que não permite uso comercial.

Em coleções

Tópicos

Perguntas frequentes

O que é NamiAgent?

Tutorial em chinês que ensina a criar um agente de IA mínimo do zero em 11 lições, com um agente local executável e uma interface no navegador. NamiAgent é um tutorial voltado a iniciantes sobre como criar agentes de IA do zero, acompanhado de um pequeno agente local que você pode executar. A ideia central é um loop `while`: chamar o modelo, executar ferramentas, registrar os resultados no contexto e chamar o modelo novamente. As lições começam com um loop mínimo de cerca de 100 linhas e adicionam uma capacidade por vez, incluindo ferramentas, permissões, gerenciamento de contexto, Skills, MCP, subagentes, planejamento e memória de longo prazo. Uma parte final explica como Claude Code, Codex e outros agentes populares são estruturados.

NamiAgent é gratuito? Qual é a licença?

NamiAgent é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

NamiAgent ainda é mantido?

Manutenção ativa. O último commit de NamiAgent foi em 30 de out. de 2026.

Para que posso usar NamiAgent?

Aprender desde o início como funcionam os loops de agentes, as ferramentas e o gerenciamento de contexto Acompanhar o código junto com as lições e comparar etapas consecutivas Executar um pequeno agente local em um workspace dedicado, com solicitações de confirmação Estudar a estrutura de agentes comerciais de programação por meio das análises incluídas

Como instalar NamiAgent?

Clone o repositório: git clone https://github.com/aa1143/NamiAgent.git Acesse o projeto e instale as dependências: cd NamiAgent && pip install -r requirements.txt Configure a chave de API do modelo e crie o workspace: export API_KEY=你的模型密钥 && export NAMI_WORKSPACE=~/agent-workspace && mkdir -p $NAMI_WORKSPACE Execute o agente da lição 5: cd lessons/lesson-05 && python agent.py

Onde consigo NamiAgent?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/aa1143/NamiAgent