Plataforma RAG pronta para produção que combina Graph RAG, busca vetorial e full-text, processamento multimodal e agentes de IA, com implantação via Docker Compose ou Kubernetes.
potpie-ai/potpie
Um grafo de contexto controlado por CLI que indexa seu codebase, issues e conhecimento da equipe para dar aos agentes de programação com IA o contexto específico do projeto.
- Estrelas
- 5,748
- Forks
- 686
- Issues abertas
- 113
- Último commit
- há 7 horas
O que é?
O Potpie cria um grafo de contexto dinâmico a partir do codebase e do ciclo de vida de desenvolvimento de software, abrangendo a estrutura do código, decisões, histórico do código-fonte, conhecimento da equipe e fluxos de trabalho de engenharia. Os agentes de programação podem consultar esse grafo para responder a perguntas, planejar mudanças, depurar falhas e escrever código adequado ao projeto.
O projeto prioriza a CLI e foi desenvolvido para pessoas e agentes. Um assistente de configuração prepara a configuração local, o armazenamento, um daemon, um workspace padrão (chamado de pot) e as skills dos agentes. Comandos como resolve e search buscam o contexto relevante antes de uma tarefa, enquanto record armazena aprendizados duradouros sobre o projeto. Uma interface web local oferece um explorador do grafo.
As integrações disponíveis atualmente incluem GitHub, Linear, Jira e Confluence. Os ambientes de programação compatíveis são Claude Code, OpenAI Codex, Cursor e OpenCode. O projeto é distribuído pelo PyPI e licenciado sob Apache 2.0.
Recursos principais
- 01Indexa a estrutura do código, pull requests, issues e o histórico do código-fonte em um único grafo de contexto.
- 02Oferece os comandos resolve e search para buscar o contexto relevante para a tarefa dos agentes.
- 03Permite que agentes registrem decisões e aprendizados duradouros sobre o projeto com o comando record.
- 04Conecta-se a fontes do GitHub, Linear, Jira e Confluence.
- 05Instala skills para agentes no Claude Code, Codex, Cursor e OpenCode.
Casos de uso
- Dar contexto sobre o projeto a um agente de programação antes que ele planeje ou edite código em um repositório desconhecido.
- Encontrar onde estão um fluxo de autenticação, um bug ou uma convenção no codebase.
- Registrar decisões de arquitetura para que sessões futuras com agentes possam consultá-las.
- Depurar falhas relacionando o histórico do código a issues e documentos associados.
Início rápido
- 1
Instale o Potpie CLI do PyPI com uv
uv tool install potpie - 2
Execute o assistente de configuração do Potpie
potpie setup - 3
Abra seu ambiente de programação configurado e peça para ele usar o Potpie no repositório
Antes de usar
- É necessário entrar no Potpie para usar recursos vinculados à conta e recursos gerenciados.
- Integrações como GitHub, Linear, Jira e Confluence precisam de credenciais separadas para se conectar.
Tópicos
Perguntas frequentes
- O que é potpie?
- Um grafo de contexto controlado por CLI que indexa seu codebase, issues e conhecimento da equipe para dar aos agentes de programação com IA o contexto específico do projeto. O Potpie cria um grafo de contexto dinâmico a partir do codebase e do ciclo de vida de desenvolvimento de software, abrangendo a estrutura do código, decisões, histórico do código-fonte, conhecimento da equipe e fluxos de trabalho de engenharia. Os agentes de programação podem consultar esse grafo para responder a perguntas, planejar mudanças, depurar falhas e escrever código adequado ao projeto.
- potpie é gratuito? Qual é a licença?
- potpie é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
- potpie ainda é mantido?
- Manutenção ativa. O último commit de potpie foi em 22 de out. de 2026.
- Para que posso usar potpie?
- Dar contexto sobre o projeto a um agente de programação antes que ele planeje ou edite código em um repositório desconhecido. Encontrar onde estão um fluxo de autenticação, um bug ou uma convenção no codebase. Registrar decisões de arquitetura para que sessões futuras com agentes possam consultá-las. Depurar falhas relacionando o histórico do código a issues e documentos associados.
- Como instalar potpie?
- Instale o Potpie CLI do PyPI com uv: uv tool install potpie Execute o assistente de configuração do Potpie: potpie setup Abra seu ambiente de programação configurado e peça para ele usar o Potpie no repositório
- Onde consigo potpie?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/potpie-ai/potpie
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Framework TypeScript para criar agentes de IA com memória, ferramentas, MCP, RAG, voz e workflows, além do console VoltOps para observabilidade.
Transforma uma base de código, sua documentação, schemas e PDFs em um grafo de conhecimento consultável por assistentes de programação com IA, criado localmente com parsing de AST usando tree-sitter.
Framework para uso autônomo de Android e computadores, que permite a um LLM planner e a um finder operar celulares e desktops a partir de tarefas em linguagem natural.
CLI e servidor MCP em C++23, sem dependências, que fornecem a agentes de programação um mapa classificado do código e verificam o impacto, os testes necessários e regressões de qualidade das alterações.
Infraestrutura aberta com SDK e CLI em Python para buscar, criar, avaliar, analisar e direcionar skills reutilizáveis para agentes de IA.