zeptoclaw
Fast, small, secure, local-first personal AI assistant infrastructure: one Rust binary for tools, memory, channels, providers, and sandboxed autonomy.
파일 탐색기
최종 버전 다운로드 (.zip)- audit.toml
- config.toml
- settings.json
- nextest.toml
- bug_report.md
- config.yml
- feature_request.md
- ci.yml
- docker.yml
- e2e.yml
- pr-hygiene.yml
- release.yml
- dependabot.yml
- PULL_REQUEST_TEMPLATE.md
- mascot-no-bg.png
- message_bus.rs
- zeptoclaw.rb
- .env.example
- digitalocean.yaml
- docker-compose.multi.yml
- docker-compose.single.yml
- fly.toml
- railway.json
- README.md
- render.yaml
- setup.sh
- architecture.md
- commands.md
- configuration.md
- pr.md
- testing.md
- 2026-02-23-linux-sandbox-runtimes-plan.md
- 2026-02-23-linux-sandbox-runtimes.md
- 2026-02-24-esp32-hardware-tools-design.md
- 2026-02-24-esp32-hardware-tools-plan.md
- 2026-02-26-control-panel-design.md
- 2026-02-26-control-panel-impl.md
- 2026-04-22-lib-crate-evaluation.md
- 2026-03-13-deep-research-and-clarification.md
- 2026-03-18-network-egress-policy.md
- 2026-03-21-tool-conformance-edit-truncation.md
- 2026-03-23-model-discoverability.md
- 2026-03-13-deep-research-skill-and-clarification-tool-design.md
- 2026-03-21-tool-conformance-edit-truncation-design.md
- 2026-03-23-model-discoverability-design.md
- ACP_IMPLEMENTATION.md
- BENCHMARK_RESULTS.md
- COMPARISON.md
- HEARTBEAT.md
- MULTI-TENANT.md
- MULTI_TENANT_SECURITY.md
- PERFORMANCE.md
- RELEASE_PROCESS.md
- scripts.md
- riscv_smoke.rs
- docs.schema.json
- content-assets.mjs
- content-modules.mjs
- content.d.ts
- types.d.ts
- favicon.svg
- logo.svg
- connections.md
- nodes.md
- triggers.md
- workflows.md
- installation.md
- introduction.md
- quick-start.md
- api-integration.md
- custom-nodes.md
- deployment.md
- error-handling.md
- cli.md
- configuration.md
- environment.md
- node-types.md
- index.mdx
- custom.css
- content.config.ts
- astro.config.mjs
- package-lock.json
- package.json
- index.html
- wrangler.toml
- favicon.svg
- logo.svg
- agent-loop.md
- channels.md
- providers.md
- tools.md
- installation.md
- introduction.md
- quick-start.md
- deployment.md
- migration.md
- plugins.md
- security.md
- templates.md
- cli.md
- configuration.md
- environment.md
- tools.md
- index.mdx
- custom.css
- content.config.ts
- astro.config.mjs
- package-lock.json
- package.json
- favicon.svg
- index.html
- mascot-no-bg.png
- og-image.png
- wrangler.toml
- deploy.sh
- react.svg
- AgentDesk.tsx
- ChatBubble.tsx
- KanbanCard.tsx
- KanbanColumn.tsx
- Layout.tsx
- Sidebar.tsx
- ToolCallBlock.tsx
- useAuth.ts
- useHealth.ts
- useMetrics.ts
- useWebSocket.ts
- api.ts
- Agents.tsx
- CronRoutines.tsx
- Dashboard.tsx
- Kanban.tsx
- Login.tsx
- Logs.tsx
- Sessions.tsx
- App.tsx
- index.css
- main.tsx
- .gitignore
- eslint.config.js
- index.html
- package.json
- pnpm-lock.yaml
- README.md
- tsconfig.app.json
- tsconfig.json
- tsconfig.node.json
- vite.config.ts
- clippy.toml
- add-tenant.sh
- backup-tenants.sh
- bench-container.sh
- container-base.sh
- fix-container.sh
- generate-compose.sh
- lint-container.sh
- pre-push
- test-container.sh
- SKILL.md
- SKILL.md
- SKILL.md
- cache.rs
- compaction.rs
- context_build.rs
- feedback.rs
- injection_scan.rs
- memory_injection.rs
- metrics.rs
- mod.rs
- provider_resolution.rs
- session.rs
- session_save.rs
- test_helpers.rs
- token_budget.rs
- budget.rs
- compaction.rs
- context.rs
- context_monitor.rs
- facade.rs
- loop.rs
- loop_guard.rs
- mod.rs
- pipeline.rs
- scratchpad.rs
- tool_call_limit.rs
- auth.rs
- channels.rs
- cron.rs
- health.rs
- metrics.rs
- mod.rs
- openai.rs
- routines.rs
- sessions.rs
- tasks.rs
- ws.rs
- auth.rs
- config.rs
- events.rs
- middleware.rs
- mod.rs
- openai_types.rs
- server.rs
- tasks.rs
- claude_import.rs
- codex_import.rs
- mod.rs
- oauth.rs
- refresh.rs
- store.rs
- benchmark.rs
- message.rs
- mod.rs
- mod.rs
- response_cache.rs
- acp.rs
- acp_http.rs
- acp_protocol.rs
- discord.rs
- email_channel.rs
- factory.rs
- lark.rs
- manager.rs
- mod.rs
- model_switch.rs
- mqtt.rs
- persona_switch.rs
- plugin.rs
- serial.rs
- slack.rs
- telegram.rs
- types.rs
- webhook.rs
- whatsapp_cloud.rs
- whatsapp_web.rs
- agent.rs
- batch.rs
- channel.rs
- common.rs
- config.rs
- daemon.rs
- doctor.rs
- gateway.rs
- hand.rs
- heartbeat.rs
- history.rs
- memory.rs
- migrate.rs
- mod.rs
- onboard.rs
- pair.rs
- panel.rs
- provider.rs
- quota.rs
- secrets.rs
- serve.rs
- shimmer.rs
- skills.rs
- slash.rs
- status.rs
- template.rs
- tools.rs
- uninstall.rs
- update.rs
- watch.rs
- mod.rs
- templates.rs
- types.rs
- validate.rs
- watcher.rs
- mod.rs
- fetcher.rs
- manager.rs
- mod.rs
- registry.rs
- types.rs
- mod.rs
- usb.rs
- container_agent.rs
- idempotency.rs
- ipc.rs
- mod.rs
- rate_limit.rs
- startup_guard.rs
- mod.rs
- discover.rs
- introspect.rs
- mod.rs
- registry.rs
- mod.rs
- service.rs
- template.rs
- mod.rs
- gate.rs
- mod.rs
- provider.rs
- registrar.rs
- handler.rs
- mod.rs
- stdio.rs
- bm25_searcher.rs
- builtin_searcher.rs
- embedding_searcher.rs
- factory.rs
- hnsw_searcher.rs
- hygiene.rs
- longterm.rs
- mod.rs
- snapshot.rs
- traits.rs
- config.rs
- mod.rs
- skills.rs
- arduino.rs
- board_profile.rs
- esp32.rs
- i2c.rs
- mod.rs
- nucleo.rs
- nvs.rs
- rpi.rs
- rpi_i2c.rs
- serial.rs
- traits.rs
- loader.rs
- mod.rs
- registry.rs
- types.rs
- watcher.rs
- claude.rs
- cooldown.rs
- error_classifier.rs
- fallback.rs
- gemini.rs
- mod.rs
- openai.rs
- plugin.rs
- quota.rs
- registry.rs
- retry.rs
- rotation.rs
- structured.rs
- types.rs
- vertex.rs
- approval.rs
- dedup.rs
- events.rs
- health.rs
- mod.rs
- engine.rs
- mod.rs
- apple.rs
- bubblewrap.rs
- docker.rs
- factory.rs
- firejail.rs
- landlock.rs
- mod.rs
- native.rs
- types.rs
- chain_alert.rs
- leak_detector.rs
- mod.rs
- policy.rs
- sanitizer.rs
- taint.rs
- validator.rs
- agent_mode.rs
- encryption.rs
- mod.rs
- mount.rs
- pairing.rs
- path.rs
- shell.rs
- history.rs
- media.rs
- mod.rs
- repair.rs
- types.rs
- github_source.rs
- loader.rs
- mod.rs
- registry.rs
- types.rs
- actions.rs
- adb.rs
- mod.rs
- screen.rs
- stuck.rs
- types.rs
- client.rs
- discovery.rs
- mod.rs
- protocol.rs
- transport.rs
- wrapper.rs
- approval.rs
- binary_plugin.rs
- browser.rs
- clarification.rs
- composed.rs
- cron.rs
- custom.rs
- delegate.rs
- diff.rs
- docx_read.rs
- filesystem.rs
- find.rs
- git.rs
- google.rs
- grep.rs
- gsheets.rs
- hardware.rs
- http_request.rs
- longterm_memory.rs
- memory.rs
- message.rs
- mod.rs
- output.rs
- pdf_read.rs
- plugin.rs
- project.rs
- r8r.rs
- registry.rs
- reminder.rs
- screenshot.rs
- shell.rs
- skills_install.rs
- skills_search.rs
- spawn.rs
- stripe.rs
- task.rs
- transcribe.rs
- types.rs
- web.rs
- whatsapp.rs
- cloudflare.rs
- mod.rs
- ngrok.rs
- tailscale.rs
- types.rs
- cost.rs
- logging.rs
- metrics.rs
- mod.rs
- sanitize.rs
- slo.rs
- string.rs
- telemetry.rs
- audit.rs
- batch.rs
- error.rs
- health.rs
- lib.rs
- main.rs
- transcription.rs
- buggy_data.py
- TASK.txt
- verify.py
- buggy_data.py
- TASK.txt
- verify.py
- .gitkeep
- edit_tool.json
- find_tool.json
- grep_tool.json
- read_tool.json
- shell_tool.json
- main.rs
- runner.rs
- docker-compose.yml
- acp_acpx.rs
- cli_smoke.rs
- e2e.rs
- integration.rs
- no_byte_slices.rs
- r8r_bridge_approval_test.rs
- r8r_bridge_client_test.rs
- r8r_bridge_events_test.rs
- .dockerignore
- .gitignore
- .kimiignore
- AGENTS.md
- Cargo.lock
- Cargo.toml
- CHANGELOG.md
- CLAUDE.md
- codecov.yml
- CONTRIBUTING.md
- deny.toml
- docker-compose.multi-tenant.yml
- docker-entrypoint.sh
- Dockerfile
- Dockerfile.dev
- install.sh
- LICENSE
- Makefile
- README.md
- SECURITY.md
# 설치 가이드
1. 코드 내려받기
git clone https://github.com/qhkm/zeptoclaw
깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.
cd zeptoclaw
방금 내려받은 프로젝트 폴더 안으로 이동합니다.
2. 공식 설치 스크립트
쉬움 추천사전 준비물
- Homebrew macOS/Linux용 패키지 매니저입니다.
- Rust (rustup) cargo 명령어를 쓰려면 Rust가 필요합니다.
curl -fsSL https://raw.githubusercontent.com/qhkm/zeptoclaw/main/install.sh | sh
공식 설치 스크립트를 다운로드해서 바로 실행합니다. 이 한 줄로 필요한 게 자동으로 설치됩니다.
brew install qhkm/tap/zeptoclaw
Homebrew로 이미 빌드된 패키지를 바로 설치합니다. 소스 빌드가 필요 없습니다.
cargo install zeptoclaw --git https://github.com/qhkm/zeptoclaw
crates.io에 배포된 패키지를 빌드해서 설치합니다. 레포를 직접 클론할 필요가 없습니다.
curl -fsSL https://zeptoclaw.com/setup.sh | bash
공식 설치 스크립트를 다운로드해서 바로 실행합니다. 이 한 줄로 필요한 게 자동으로 설치됩니다.
설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.
이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.
3. Docker
쉬움사전 준비물
- Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
- Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.
docker pull ghcr.io/qhkm/zeptoclaw:latest
이 명령어를 터미널에 그대로 입력해 실행하세요.
터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.
이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.
4. Node.js
쉬움사전 준비물
cd panel
이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.
npm install
package.json에 명시된 라이브러리들을 내려받아 설치합니다.
npm start
개발/실행 서버를 켭니다.
명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.
5. Rust
보통사전 준비물
- Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
- Rust (rustup) rustup으로 설치하면 cargo도 함께 설치됩니다.
cargo install zeptoclaw --git https://github.com/qhkm/zeptoclaw
crates.io에 배포된 패키지를 빌드해서 설치합니다. 레포를 직접 클론할 필요가 없습니다.
cargo uninstall zeptoclaw
이 명령어를 터미널에 그대로 입력해 실행하세요.
cargo build
Rust 프로젝트를 컴파일합니다.
cargo nextest run --lib
이 명령어를 터미널에 그대로 입력해 실행하세요.
cargo clippy -- -D warnings
이 명령어를 터미널에 그대로 입력해 실행하세요.
cargo build가 에러 없이 끝나면 성공입니다. target/ 폴더에 실행 파일이 생성됩니다.
이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.
6. Make
보통사전 준비물
- Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
- Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.
make
생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.
에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.
// repository documentation
Was this content helpful?
(0 ratings)