Metadata-Version: 2.4
Name: phosphobot
Version: 0.3.1
Summary: The AI-ready robotics dev kit, with built-in remote control and VLA support.
Author-email: phospho <contact@phospho.ai>
License-Expression: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: dynamixel-sdk>=3.7.31
Requires-Dist: fastapi[standard]>=0.115.5
Requires-Dist: loguru>=0.7.2
Requires-Dist: rich>=13.9.4
Requires-Dist: matplotlib>=3.9.3
Requires-Dist: numpy<2
Requires-Dist: pybullet>=3.2.7
Requires-Dist: pydantic>=2.10.2
Requires-Dist: scipy>=1.14.1
Requires-Dist: uvicorn>=0.32.1
Requires-Dist: opencv-python-headless>=4.0
Requires-Dist: requests>=2.32.0
Requires-Dist: types-requests>=2.32.0.20241016
Requires-Dist: json-numpy>=2.1.0
Requires-Dist: pandas>=2.2
Requires-Dist: tqdm>=4.67.1
Requires-Dist: feetech-servo-sdk>=1.0.0
Requires-Dist: typer>=0.15.1
Requires-Dist: websockets>=14.1
Requires-Dist: huggingface-hub>=0.28.0
Requires-Dist: datasets>=3.2.0
Requires-Dist: sentry-sdk[fastapi]>=2.20.0
Requires-Dist: posthog>=3.11.0
Requires-Dist: piper-sdk>=0.1.16
Requires-Dist: supabase>=2.15.0
Requires-Dist: zmq>=0.0.0
Requires-Dist: toml>=0.10.2
Requires-Dist: av>=14.3.0
Requires-Dist: tyro>=0.9.20
Requires-Dist: types-toml>=0.10.8.20240310
Requires-Dist: pyrealsense2>=2.54; platform_system == "Linux"
Requires-Dist: pyrealsense2>=2.54; platform_system == "Windows"
Requires-Dist: pyrealsense2-macosx>=2.54; platform_system == "Darwin"
Requires-Dist: fastparquet>=2024.11.0
Requires-Dist: httpx>=0.28.1

**phosphobot** – CLI Toolkit for Robot Teleoperation and Action Models
[![PyPI version](https://img.shields.io/pypi/v/phosphobot?style=flat-square)](https://pypi.org/project/phosphobot/)
[![GitHub](https://img.shields.io/badge/GitHub-Repo-blue?style=flat-square)](https://github.com/phospho-app/phosphobot)
[![Discord](https://img.shields.io/discord/1106594252043071509?style=flat-square)](https://discord.gg/cbkggY6NSK)

A simple, community-driven middleware for controlling robots, recording datasets, training action models.

All from your terminal or browser dashboard.

---

## Features

- **Easy Installation** via `pip` or the `uv` package manager
- **Web Dashboard**: Instant access to an interactive control panel for teleoperation
- **Dataset Recording**: Record expert demonstrations with a keyboard, in VR, or with a leader arm
- **Model Training & Inference**: Kick off training jobs or serve models through HTTP/WebSocket APIs

---

## Installation

### 1. Using pip

```bash
pip install phosphobot
```

### 2. Using [uv](https://github.com/astral-sh/uv)

If you already use `uv` to manage Python versions and deps:

```bash
# Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Add phosphobot to your project
uv add phosphobot
```

---

## Quick Start

Once installed, you can start the phosphobot server instantly.

```bash
# Verify installation and view info
phosphobot info

# Start the teleoperation server (default: localhost:80)
phosphobot run

# For custom port, e.g. 8080
phosphobot run --port 8080
```

If you’re managing via uv:

```bash
uv run phosphobot info
uv run phosphobot run
```

---

## Dashboard & Control

After launching the server, open your browser and navigate to:

```
http://<YOUR_SERVER_ADDRESS>:<PORT>/
```

By default, the address is [localhost:80](localhost:80)

Here you can:

- **Teleoperate** your robot via keyboard, leader arm, or Meta Quest
- **Record** demonstration datasets (40 episodes recommended)
- **Train** and **deploy** action models directly from the UI

---

## Start building

- **Docs**: Full user guide at [https://docs.phospho.ai](https://docs.phospho.ai)
- **Discord**: Join us on Discord for support and community chat: [https://discord.gg/cbkggY6NSK](https://discord.gg/cbkggY6NSK)
- **GitHub Repo**: [https://github.com/phospho-app/phosphobot](https://github.com/phospho-app/phosphobot)
- **Examples**: Browse [the examples](https://github.com/phospho-app/phosphobot/tree/main/examples)
- **Contribute**: Open a PR to expand the examples, support more robots, improve the tool

---

## License

MIT License

Made with 💚 by the Phospho community.
