tars-robot 0.5.7

TARS robot control library with daemon, dashboard, and SDK

TARS

Note: This is a fork of TARS-AI-Community/TARS-AI with a distributed architecture. The original runs everything on the Pi. This fork separates the hardware daemon from the AI pipeline, exposing gRPC and WebRTC APIs so anyone can build apps that control the robot. Looking for voice conversation? See tars-conversation-app.

Raspberry Pi 5 robot daemon. Handles servo control, WebRTC audio streaming, display, camera, and battery monitoring. Apps connect via gRPC and WebRTC.

What You Need

Hardware:

• Raspberry Pi 5 (or Pi 4 4GB+)
• PCA9685 servo driver + servos
• USB audio adapter
• Pi Camera or USB webcam
• INA260 battery monitor (optional)
• 12V battery pack

Software:

• Python 3.9+

---

Quick Start

1. Install on Pi

pip install tars-robot[daemon]
tars-daemon

Dashboard: http://tars.local:8000

2. Install an App

Browse and install apps from the dashboard's Apps tab.

Featured:

• tars-conversation-app — Voice AI (LLM, STT, TTS)

Or install manually:

# Featured: voice AI pipeline
pip install tars-conversation-app

---

Installation

	PyPI	Git clone
Install time	Fast	Moderate
Dashboard updates	One-click from UI	git pull
Modify daemon code	No	Yes
Servo tester / dev tools	tars-servo-tester CLI	python src/app-servotester.py

PyPI (Recommended)

pip install tars-robot[daemon]
tars-daemon

Git Clone (Development)

git clone https://github.com/latishab/tars.git
cd tars && pip install -e .[daemon]
tars-daemon

SDK Only (Remote Control)

pip install tars-robot

from tars_sdk import TarsClient

client = TarsClient("tars.local:50051")
client.move("wave_right")
client.set_emotion("happy")
client.close()

---

Architecture

App (any machine)                     tars-daemon (Raspberry Pi)
─────────────────────────────────     ─────────────────────────────
tars-conversation-app                   ├── gRPC Server (:50051)
  ├── LLM (Claude)                      ├── HTTP + Dashboard (:8000)
  ├── STT (Deepgram)                    ├── WebRTC Audio
  ├── TTS (Kokoro)                      ├── Servo Control (PCA9685)
  └── TarsClient SDK ─────────────────►├── Display (pygame)
                        gRPC :50051     ├── Camera
                        WebRTC :8000    └── Battery (INA260)

Apps connect via gRPC (:50051) and WebRTC (:8000). They can run on a separate computer or on the Pi itself.

---

Apps

TARS supports installable apps. Browse and install from the dashboard's Apps tab.

Featured:

• tars-conversation-app — Voice AI pipeline (LLM, STT, TTS). Talk to your robot.

More apps coming soon.

---

Documentation

• Installation
• API Reference
• WiFi Setup
• Servo Calibration
• Daemon
• Dashboard
• Architecture

---

License

See LEGAL.md.