ShenSeanChen/waku-agent

어떤 프로젝트인가요?

핵심 기능

• 01추론하고 행동한 뒤 반복하는, 일반 Python으로 작성된 약 95줄의 에이전트 루프
• 02로컬 SQLite 파일에 저장되는 시맨틱·에피소딕·절차적 메모리
• 03터미널, 브라우저 대시보드, Telegram, Discord, 음성 게이트웨이
• 04릴리스 게이트가 포함된 결정론적 테스트와 LLM-as-judge eval
• 05Anthropic, OpenAI, Gemini, OpenRouter 등 여러 모델 제공자 지원

활용 사례

• 메모리를 로컬에 보관하는 개인용 비서를 노트북에서 실행하기
• 작은 코드베이스에서 에이전트 루프, 메모리 검색, eval이 어떻게 맞물리는지 살펴보기
• 하네스를 포크해 새 메시징 게이트웨이나 도구 추가하기
• Waku Memory를 통해 Claude Code, Codex 및 다른 에이전트에서 메모리 하나를 공유하기

빠른 시작

1. 1

   PyPI에서 패키지를 설치하세요

   pip install waku-agent
2. 2

   터미널에서 Waku와 대화하세요(처음 실행할 때 API 키를 입력하라는 메시지가 표시됩니다)

   waku
3. 3

   또는 localhost:7777에서 브라우저 대시보드를 여세요

   waku dashboard

사용 전 알아둘 점

• !실행하려면 모델 제공업체(예: Anthropic, OpenAI)의 API 키가 필요합니다.

토픽

자주 묻는 질문

waku-agent은(는) 무엇인가요?

읽기 쉬운 Python으로 작성된 로컬 우선 개인용 AI 비서로, 자체 에이전트 루프와 SQLite 기반 메모리, 내장 eval을 제공합니다. waku-agent는 사용자의 컴퓨터에서 실행되는 개인용 AI 비서입니다. 네 가지 구성 요소를 중심으로 만들어졌습니다. 터미널, 브라우저 대시보드, Telegram, Discord 같은 게이트웨이를 하나의 에이전트 루프에 연결하는 하네스, 추론하고 행동한 뒤 반복하는 약 95줄의 Python 루프, 시맨틱·에피소딕·절차적(스킬) 메모리를 아우르는 메모리 시스템, 결정론적 테스트와 LLM-as-judge 점수를 결합하는 eval 계층입니다.

waku-agent은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

waku-agent은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

waku-agent은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. waku-agent의 마지막 커밋은 2026년 10월 11일입니다.

waku-agent은(는) 어디에 사용할 수 있나요?

메모리를 로컬에 보관하는 개인용 비서를 노트북에서 실행하기 작은 코드베이스에서 에이전트 루프, 메모리 검색, eval이 어떻게 맞물리는지 살펴보기 하네스를 포크해 새 메시징 게이트웨이나 도구 추가하기 Waku Memory를 통해 Claude Code, Codex 및 다른 에이전트에서 메모리 하나를 공유하기

waku-agent는 어떻게 설치하나요?

PyPI에서 패키지를 설치하세요: pip install waku-agent 터미널에서 Waku와 대화하세요(처음 실행할 때 API 키를 입력하라는 메시지가 표시됩니다): waku 또는 localhost:7777에서 브라우저 대시보드를 여세요: waku dashboard

waku-agent은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ShenSeanChen/waku-agent