Tiny Engineer

AI 코딩 에이전트에게 몸을 입혀주세요.

Tiny Engineer demo

데모 보기 · 직접 만들기 · 커뮤니티 빌드 · 작동 원리

책상 위에 놓는 작은 로봇입니다. 코딩 AI 에이전트가 작동하는 동안 움직이고, 표정을 바꾸고, 종을 울립니다.

오픈 소스입니다. 본체(body)를 출력하고, ESP32, 서보 모터(servos), OLED, 스피커를 메인 제어 보드에 연결한 후, 플래싱하여 Wi-Fi에 연결하면 됩니다.

호환되는 에이전트: Claude Code · Cursor · Antigravity — npx -y tiny-engineer setup를 통해 — 또는 Codex, Windsurf 및 POST가 가능한 모든 스크립트 (통합 가이드 · HTTP API)를 포함하며, POST /play를 통한 음성 출력도 가능합니다.

직접 만들기 (Build your own)

| | |
| :--- |
| 부품 (전자 부품 + 5× SG90 서보 모터) | 쇼핑 목록: 메인 제어 보드와 ESP32, 서보 모터, OLED, 스피커
| ... |

Main control board

기본 빌드는 오픈 소스 메인 제어 보드를 사용합니다. 원하는 곳(fab)에서 주문할 수 있습니다 (주문 방법 · KiCad).

만약 이처럼 조립된 ~$15–20짜리 보드가 유용하다면, 여기 투표하기 👍 → → 저는 관심사를 바탕으로 추가 개발할 가치가 있는지 결정하려고 합니다.

출력(Print) → 연결(Connect) → 플래싱(Flash) → 조립(Assemble) - 단계별 과정은 **시작하기**를 참고하세요.

커뮤니티 빌드 (Community builds)

Built Tiny Engineer

완성된 빌드, 개조품(mods), 책상 세팅 사진은 GitHub Discussions의 **Show and tell**에 올라와 있습니다. 다른 사람들이 만든 것을 둘러보고 자신의 사진을 게시해 보세요.

만들어 본 사람 있나요? Show and tell에서 공유하기 →

로드맵 (Roadmap)

우리가 만들고 있는 방향:

• 더 많은 에이전트 통합(agent integrations) - 더 많은 IDE와 CLI를 위한 원클릭 후크 기능
• 간소화된 빌드 프로세스(Simplified build process) - 빠르고 쉬운 조립 및 설정으로 빠른 빌드를 가능하게 함
• 새로운 캐릭터/바디(New characters / bodies) - 대체 쉘과 모드
• 멀티 에이전트 데스크(Multi-agent desk) - 하나의 작은 팀원 이상

빌드 과정을 팔로우하려면 Tiny Engineer를 Star 하세요.

작동 방식 (How it works)

How Tiny Engineer works

사용자의 에이전트(또는 후크 스크립트)가 Wi‑Fi HTTP 또는 **USB 시리얼(serial)**을 통해 포즈를 전송합니다. ESP32-C3가 펌웨어를 실행하고, 선택적 Wi‑Fi/REST, USB CDC 제어 및 서보 모터, 얼굴, 스피커를 구동합니다.

클라이언트 (Clients)

• 기본(Default) — Cursor, Claude Code, Antigravity용 npx -y tiny-engineer (setup / hook) (HTTP 또는 --transport serial)
• 고급(Advanced) — POST /anim (HTTP API) 또는 프레임화된 USB 시리얼(serial.md)

자세한 내용은: 통합 기능(Integrations) · HTTP API · USB 시리얼 · Cursor 후크

문서 (Documentation)

이것을 인쇄하고, 연결하고, CAD를 변경하거나, 다른 에이전트를 후크할 수 있습니다. 문제점(Issues)과 PR은 환영합니다. 특히 새로운 통합 기능에 대한 기여가 좋습니다. CONTRIBUTING.md · SECURITY.md · CODE_OF_CONDUCT.md

라이선스 (License)

• 소프트웨어 (펌웨어, 통합 기능, 스크립트, 문서) — MIT
• 하드웨어 디자인 (CAD 소스 및 인쇄 가능 파일은 3d_models/와 mods/*/3d_models/; KiCad PCB는 hardware/) — CERN-OHL-S-2.0

범위 및 유효 날짜는 LICENSING.md를 참조하세요. Tiny Engineer 이름과 로고는 라이선스가 부여되지 않았습니다. TRADEMARK.md를 참조하세요.