Graph RAG, 벡터 및 전문 검색, 멀티모달 파싱, AI 에이전트를 결합한 프로덕션급 RAG 플랫폼으로, Docker Compose 또는 Kubernetes에 배포할 수 있습니다.
potpie-ai/potpie
코드베이스, 이슈, 팀 지식을 색인하는 CLI 기반 컨텍스트 그래프로, AI 코딩 에이전트가 프로젝트에 맞는 맥락을 활용하도록 지원합니다.
- 스타
- 5,748
- 포크
- 686
- 열린 이슈
- 113
- 마지막 커밋
- 7시간 전
어떤 프로젝트인가요?
Potpie는 코드 구조, 의사결정, 소스 이력, 팀 지식, 엔지니어링 워크플로를 아우르는 코드베이스와 소프트웨어 개발 수명 주기의 살아 있는 컨텍스트 그래프를 구축합니다. 코딩 에이전트는 이 그래프를 조회해 질문에 답하고, 변경을 계획하고, 오류를 디버깅하며, 프로젝트에 맞는 코드를 작성할 수 있습니다.
이 프로젝트는 CLI를 우선하며 사람과 에이전트 모두를 위해 설계되었습니다. 설정 마법사는 로컬 설정, 저장소, 데몬, 기본 작업 공간(‘pot’이라고 함), 에이전트 스킬을 구성합니다. resolve 및 search 같은 명령으로 작업을 시작하기 전에 관련 맥락을 가져오고, record 명령으로 프로젝트의 유용한 지식을 지속적으로 저장할 수 있습니다. 로컬 웹 UI에서는 그래프를 탐색할 수 있습니다.
현재 GitHub, Linear, Jira, Confluence와 연동됩니다. 지원하는 코딩 하네스는 Claude Code, OpenAI Codex, Cursor, OpenCode입니다. PyPI를 통해 배포되며 Apache 2.0 라이선스를 따릅니다.
핵심 기능
- 01코드 구조, pull request, 이슈, 소스 이력을 하나의 컨텍스트 그래프로 색인합니다.
- 02resolve 및 search 명령으로 에이전트가 작업에 필요한 맥락을 가져올 수 있습니다.
- 03record 명령으로 에이전트가 프로젝트의 의사결정과 유용한 지식을 지속적으로 저장할 수 있습니다.
- 04GitHub, Linear, Jira, Confluence 소스와 연결됩니다.
- 05Claude Code, Codex, Cursor, OpenCode용 에이전트 스킬을 설치합니다.
활용 사례
- 익숙하지 않은 저장소에서 코드를 계획하거나 수정하기 전에 코딩 에이전트에 프로젝트 배경 정보를 제공합니다.
- 코드베이스에서 인증 흐름, 버그, 규칙이 있는 위치를 찾습니다.
- 아키텍처 결정을 기록해 이후 에이전트 세션에서 참조할 수 있도록 합니다.
- 코드 이력을 관련 이슈 및 문서와 연결해 오류를 디버깅합니다.
빠른 시작
- 1
uv를 사용해 PyPI에서 Potpie CLI를 설치합니다
uv tool install potpie - 2
Potpie 설정 마법사를 실행합니다
potpie setup - 3
설정된 코딩 하네스를 열고 저장소에서 Potpie를 사용하도록 요청합니다
사용 전 알아둘 점
- 계정 기반 기능과 관리형 기능을 사용하려면 Potpie에 로그인해야 합니다.
- GitHub, Linear, Jira, Confluence 등의 통합을 연결하려면 별도의 인증 정보가 필요합니다.
토픽
자주 묻는 질문
- potpie은(는) 무엇인가요?
- 코드베이스, 이슈, 팀 지식을 색인하는 CLI 기반 컨텍스트 그래프로, AI 코딩 에이전트가 프로젝트에 맞는 맥락을 활용하도록 지원합니다. Potpie는 코드 구조, 의사결정, 소스 이력, 팀 지식, 엔지니어링 워크플로를 아우르는 코드베이스와 소프트웨어 개발 수명 주기의 살아 있는 컨텍스트 그래프를 구축합니다. 코딩 에이전트는 이 그래프를 조회해 질문에 답하고, 변경을 계획하고, 오류를 디버깅하며, 프로젝트에 맞는 코드를 작성할 수 있습니다.
- potpie은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- potpie은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- potpie은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. potpie의 마지막 커밋은 2026년 10월 22일입니다.
- potpie은(는) 어디에 사용할 수 있나요?
- 익숙하지 않은 저장소에서 코드를 계획하거나 수정하기 전에 코딩 에이전트에 프로젝트 배경 정보를 제공합니다. 코드베이스에서 인증 흐름, 버그, 규칙이 있는 위치를 찾습니다. 아키텍처 결정을 기록해 이후 에이전트 세션에서 참조할 수 있도록 합니다. 코드 이력을 관련 이슈 및 문서와 연결해 오류를 디버깅합니다.
- potpie는 어떻게 설치하나요?
- uv를 사용해 PyPI에서 Potpie CLI를 설치합니다: uv tool install potpie Potpie 설정 마법사를 실행합니다: potpie setup 설정된 코딩 하네스를 열고 저장소에서 Potpie를 사용하도록 요청합니다
- potpie은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/potpie-ai/potpie
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
메모리, 도구, MCP, RAG, 음성, 워크플로를 지원하는 AI 에이전트 구축용 TypeScript 프레임워크와 관측성을 위한 VoltOps 콘솔입니다.
tree-sitter AST 파싱으로 코드베이스, 문서, 스키마, PDF를 로컬에서 질의 가능한 지식 그래프로 변환합니다.
자연어 작업을 바탕으로 플래너와 파인더 LLM이 휴대폰과 데스크톱을 조작하는 프레임워크입니다.
코딩 에이전트에 코드베이스의 우선순위별 지도를 제공하고, 변경 사항의 영향 범위와 실행할 테스트, 품질 저하를 점검하는 무의존성 C++23 CLI 및 MCP 서버입니다.
재사용 가능한 AI 에이전트 스킬을 검색·생성·평가·분석·라우팅하는 Python SDK와 CLI를 갖춘 오픈 인프라입니다.