tatbot

tattoo robot system composed of 2 robot arms, 7 cameras, and 6 computers controlling 2 tattoo machines. Built in public, all open source, reserve your tattoo, follow the progress

---

Quick Start

Essential Commands

• ./scripts/mcp_run.sh - Start MCP server

• ./scripts/setup_env.sh - Install dependencies

Documentation Index

🤖 Hardware & Control

• Robot System - Trossen arms, URDF models, inverse kinematics

• Vision System - Cameras, AprilTag tracking, 2D→3D mapping

• Tattoo Gear - Physical tattoo equipment and setup

🌐 Software Architecture

• MCP Protocol - Model Context Protocol for distributed control

• Tools System - Unified operation framework and tool registry

• Network Architecture - Automatic dual-mode networking

• Agent Interface - LLM-based control system

🎨 Art & Visualization

• Artwork Pipeline - From images to tattoo designs

• 3D Visualization - Real-time robot visualization with Viser

• VGGT System - 3D reconstruction and surface mapping

🧠 AI & Models

• Model Plans - Vision-language-action model development

• Training Data - Dataset collection and management

• Gr00t Integration - Foundation model interface

• SmolVLA - Compact vision-language-action model

🔧 Operations & Monitoring

• State Server - Redis-based state management

• TUI Monitor - Real-time system dashboard

• Development Workflows - Coding, testing, and deployment

📚 Reference

• Style Guide - Code and documentation standards

• Progress Tracking - Development milestones and status

• Research Ideas - Future development directions

• Academic Paper - Research publication and figures