Skip to content

mathias-heide/clawdboy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ClawdBoy

License: MIT

Open-source handheld AI assistant. Voice in, voice out. Runs on your own VPS. Fully hackable.

What is ClawdBoy?

ClawdBoy is a dedicated AI companion device with retro handheld aesthetics. It runs on a UNIHIKER single-board computer and connects to your own VPS running Clawdbot.

  • Voice interface - Talk to it, it talks back
  • Your own server - Data stays on your VPS, not someone else's cloud
  • Fully hackable - Write custom skills in Python, customize the UI
  • Open source - MIT licensed, fork it, make it yours

Project Structure

clawdboy/
├── website/     # Next.js web app (clawdboy.com)
├── device/      # Python code for UNIHIKER device
└── docs/        # Documentation (coming soon)

Getting Started

Website Development

cd website
npm install
npm run dev

Device Development

cd device
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
# Edit .env with your VPS details
python main.py

Tech Stack

Website (clawdboy.com)

  • Next.js 16
  • Tailwind CSS
  • Supabase (auth + database)
  • Vercel (hosting)

Device

  • Python
  • UNIHIKER hardware
  • Connects to Clawdbot on your VPS

Backend (per-user VPS)

  • Clawdbot
  • Claude API (Anthropic)
  • Groq (speech-to-text)

Contributing

Contributions welcome! This project is in early development.

  1. Fork the repo
  2. Create your feature branch (git checkout -b feature/cool-thing)
  3. Commit your changes (git commit -m 'Add cool thing')
  4. Push to the branch (git push origin feature/cool-thing)
  5. Open a Pull Request

License

MIT License - see LICENSE for details.

Links


Built with love from Summer Engine.

About

Open-source handheld AI assistant. Voice in, voice out. Runs on your own VPS. Fully hackable. With love from Summer Engine.

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors