Waku: 로컬에서 작동하는 개인 AI 비서

원문 발행 2026. 10. 12. 08:44원문 언어 영어AI 한국어 번역GitHub AI Coding Assistants 원문 보기

요약

Waku는 로컬 우선(local-first) 원칙을 따르는 개인 AI 비서 프레임워크입니다. 이 시스템은 Harness, Loop, Memory, Eval/LLM-Ops의 네 가지 핵심 기둥으로 구성되어 에이전트 기능을 구현합니다. 사용자는 자신의 메모리를 SQLite 파일로 관리하며, Anthropic, OpenAI 등 다양한 모델을 연결하여 사용할 수 있습니다.

핵심 포인트

Waku는 로컬 우선(local-first) 개인 AI 비서 프레임워크입니다.
Harness, Loop, Memory, Eval/LLM-Ops 4가지 핵심 기둥으로 구성됩니다.
사용자 메모리는 SQLite 파일로 관리되어 데이터 소유권을 보장합니다.
다양한 LLM 제공업체(Anthropic, OpenAI 등)를 어댑터를 통해 통합 지원합니다.

자신만의 AI 비서. 노트북에서. 오후 안에 읽을 수 있는 코드 형태로.

Waku를 만나보세요. 모든 진지한 에이전트의 네 가지 기둥, 즉 Harness · Loop · Memory · Eval/LLM-Ops를 보여주는 로컬 우선(local-first) 개인 비서입니다. 좋은 기능을 숨기는 프레임워크는 없습니다. seanchen.io에서 제작했습니다.

로컬 우선(Local-first). 당신의 메모리는 하나의 SQLite 파일입니다. 열어보세요. 읽어보세요. 그것은 당신의 것입니다.메모리가 핵심입니다. 의미론적(Semantic) + 일화적(Episodic) + 절차적(Procedural) — 기억할지 결정하는 게이트와 무엇을 보존할지 결정하는 패스가 있습니다.루프는 순수 Python 코드 약 95줄입니다. 단계별로 실행해 보세요.생각하는 것을 지켜보세요. 로컬 대시보드가 메시지가 하우징(harness)을 통과할 때마다 빛납니다.Eval이 내장되어 있습니다. 결정론적 테스트(Deterministic tests)와 LLM-as-judge가 나란히, 릴리스 게이트와 함께 작동합니다.

이 시리즈의 시스템 설계 화이트보드입니다. 모든 상자는 파일에 매핑되므로 아키텍처를 확인해 보세요.

▶ 20분 코드 워크스루 시청하기 — 루프, 메모리 기둥, 평가(evals), Telegram 게이트웨이 및

이미 비용을 지불하는 모델을 사용하세요. Anthropic(기본값), OpenAI, Gemini, DeepSeek, MiniMax, Kimi, GLM, OpenRouter(하나의 키로 수백 개의 호스팅된 모델 이용 가능), OpenCode Zen 또는 OpenCode Go — WAKU_PROVIDER=에 설정하고, 키를 붙여넣으면 끝입니다. 하나의 방언만 루프 안에 있으면 나머지 처리는 어댑터가 처리합니다.

처음이신가요? 시작하기(Getting started) 가 전체 설정을 안내하며, 매 단계마다 확인 절차가 있습니다.

Waku 자체 메모리는 로컬입니다. Waku Memory는 에이전트 간에 공유하는 호스팅 메모리입니다. Claude Code에서 무언가를 저장하고, 여기서 다시 불러올 수 있습니다.

pip install 'waku-agent[mcp]' # 체크아웃 폴더에서: uv pip install -e '.[mcp]'
waku connect waku-memory # 또는 대시보드 채팅에서 /connect waku-memory
waku skill export --to claude,codex # Waku의 스킬을 Claude Code와 Codex로도 가져가기```

브라우저에 한 번 접속하여 로그인합니다. Claude Code, Codex, Hermes 또는 Grok Bot을 동일한 메모리에 연결하려면 통합(integrations) 섹션을 참조하세요.
연구를 할 때 실시간 데이터가 필요하면, `waku connect treg` (또는 `/connect treg`) 를 사용하여 자신의 treg 계정에 접속합니다. 역시 통합 섹션을 참고하세요.

| 핵심 구성 요소 | 한 줄 요약 | 더 알아보기 |
|---|---|---|
| Harness | 게이트웨이(터미널, 대시보드, 음성, Telegram, Discord, WhatsApp)와 도구들을 하나의 루프 안에 통합합니다. | 아키텍처 | 
| Loop | 순수 Python 약 95줄: 추론(reason), 행동(act), 반복(repeat)하며, 중지할 수 있는 두 가지 방법이 있습니다. | 투어 보기 |
| Memory | 의미적(semantic), 일화적(episodic), 절차적(procedural)(스킬); 게이트가 기억할지 결정하고, 통합(consolidation)이 무엇을 보존할지 결정합니다. | 투어 보기 |
| Eval / LLM-Ops | 결정론적 테스트와 LLM-as-judge를 나란히 배치하며, 릴리스 게이트와 모든 턴에 대한 추적 기록을 제공합니다. | 평가(evals) | 

**ChatGPT나 Claude Desktop과는 어떻게 다른가요?** 그것들은 사용자가 *사용하는* 제품입니다. 이것은 사용자가 *소유하는* 코드베이스입니다: 루프, 메모리 스키마, 게이트, 그리고 평가 하네스 모두 읽고 변경할 수 있습니다. 대규모 오픈소스 어시스턴트(OpenClaw, Hermes)와 비교하면? 아키텍처는 같지만 코드는 1/100 수준입니다.

| Read | For |
|---|---|
| Getting started | 설치 방법, 첫 실행, Waku Memory 연결 |
| ... | |
저장소에 별표를 찍고, Discord에 참여하고, 좋은 초기 이슈를 잡아보세요. 그 링크는 실시간 목록이니 항상 최신입니다. 게이트웨이(Gateways), 메모리 백엔드(memory backends) 및 커뮤니티 스킬은 모두 첫 PR로 만들어지도록 설계되었습니다. 가장 쉬운 것은 Python이 전혀 필요하지 않습니다 (스킬 기여하기 참조). 

**시작하기 전에 이슈에 댓글을 달면** 자동으로 당신에게 할당되므로, 두 사람이 같은 것을 만들지 않게 됩니다.

**launch-mvp-stripe-nextjs-supabase** — NextJS + Supabase + Stripe로 SaaS를 출시하는 데 필요한 모든 것입니다.**AutoManus.io** — 저의 AI 스타트업: 주문 제작 상품을 위한 영업 리드 관리자입니다. 이미 대화가 이루어지는 곳(WhatsApp, 이메일, 웹 채팅)에 내장되어 인바운드를 포착하고, 후속 조치를 자동화하며, CRM 업무를 간소화합니다. Character VC의 프리시드 투자를 받았습니다. (AutoManus Discord)

코드는 MIT 라이선스이며, LICENSE를 참조하세요 — **단, hosted/는 Elastic License 2.0**입니다: 직접 실행할 수는 있지만, 다른 사람을 위한 서비스로 제공할 수는 없습니다. hosted/LICENSE를 참조하세요.

`waku/`

자체 하우징(harness) 자체와 PyPI가 배포하는 모든 것은 MIT 라이선스입니다. Waku 이름, 상표 및 디자인 시스템은 AutoManus Technologies, Inc.에 속하며 MIT 라이선스가 아닙니다 — LICENSE-BRAND를 참조하세요. @ShenSeanChen (YouTube · X)이 구축했습니다.

AI 자동 생성 콘텐츠

원문 바로가기

pip install 'waku-agent[mcp]' # 체크아웃 폴더에서: uv pip install -e '.[mcp]' waku connect waku-memory # 또는 대시보드 채팅에서 /connect waku-memory waku skill export --to claude,codex # Waku의 스킬을 Claude Code와 Codex로도 가져가기``` 브라우저에 한 번 접속하여 로그인합니다. Claude Code, Codex, Hermes 또는 Grok Bot을 동일한 메모리에 연결하려면 통합(integrations) 섹션을 참조하세요. 연구를 할 때 실시간 데이터가 필요하면, `waku connect treg` (또는 `/connect treg`) 를 사용하여 자신의 treg 계정에 접속합니다. 역시 통합 섹션을 참고하세요. | 핵심 구성 요소 | 한 줄 요약 | 더 알아보기 | |---|---|---| | Harness | 게이트웨이(터미널, 대시보드, 음성, Telegram, Discord, WhatsApp)와 도구들을 하나의 루프 안에 통합합니다. | 아키텍처 | | Loop | 순수 Python 약 95줄: 추론(reason), 행동(act), 반복(repeat)하며, 중지할 수 있는 두 가지 방법이 있습니다. | 투어 보기 | | Memory | 의미적(semantic), 일화적(episodic), 절차적(procedural)(스킬); 게이트가 기억할지 결정하고, 통합(consolidation)이 무엇을 보존할지 결정합니다. | 투어 보기 | | Eval / LLM-Ops | 결정론적 테스트와 LLM-as-judge를 나란히 배치하며, 릴리스 게이트와 모든 턴에 대한 추적 기록을 제공합니다. | 평가(evals) | **ChatGPT나 Claude Desktop과는 어떻게 다른가요?** 그것들은 사용자가 *사용하는* 제품입니다. 이것은 사용자가 *소유하는* 코드베이스입니다: 루프, 메모리 스키마, 게이트, 그리고 평가 하네스 모두 읽고 변경할 수 있습니다. 대규모 오픈소스 어시스턴트(OpenClaw, Hermes)와 비교하면? 아키텍처는 같지만 코드는 1/100 수준입니다. | Read | For | |---|---| | Getting started | 설치 방법, 첫 실행, Waku Memory 연결 | | ... | | 저장소에 별표를 찍고, Discord에 참여하고, 좋은 초기 이슈를 잡아보세요. 그 링크는 실시간 목록이니 항상 최신입니다. 게이트웨이(Gateways), 메모리 백엔드(memory backends) 및 커뮤니티 스킬은 모두 첫 PR로 만들어지도록 설계되었습니다. 가장 쉬운 것은 Python이 전혀 필요하지 않습니다 (스킬 기여하기 참조). **시작하기 전에 이슈에 댓글을 달면** 자동으로 당신에게 할당되므로, 두 사람이 같은 것을 만들지 않게 됩니다. **launch-mvp-stripe-nextjs-supabase** — NextJS + Supabase + Stripe로 SaaS를 출시하는 데 필요한 모든 것입니다.**AutoManus.io** — 저의 AI 스타트업: 주문 제작 상품을 위한 영업 리드 관리자입니다. 이미 대화가 이루어지는 곳(WhatsApp, 이메일, 웹 채팅)에 내장되어 인바운드를 포착하고, 후속 조치를 자동화하며, CRM 업무를 간소화합니다. Character VC의 프리시드 투자를 받았습니다. (AutoManus Discord) 코드는 MIT 라이선스이며, LICENSE를 참조하세요 — **단, hosted/는 Elastic License 2.0**입니다: 직접 실행할 수는 있지만, 다른 사람을 위한 서비스로 제공할 수는 없습니다. hosted/LICENSE를 참조하세요. `waku/` 자체 하우징(harness) 자체와 PyPI가 배포하는 모든 것은 MIT 라이선스입니다. Waku 이름, 상표 및 디자인 시스템은 AutoManus Technologies, Inc.에 속하며 MIT 라이선스가 아닙니다 — LICENSE-BRAND를 참조하세요. @ShenSeanChen (YouTube · X)이 구축했습니다.