Skip to main content

The AI-ready robotics dev kit, with built-in remote control.

Project description

phosphobot

A community-driven platform for robotics enthusiasts to share and explore creative projects built with the phospho Junior Dev Kit.

phosphobot Python package on PyPi Y Combinator W24 phospho discord

Overview

This repository contains demo code and community projects developed using the phospho Junior Dev Kit. Whether you're a beginner or an experienced developer, you can explore existing projects or contribute your own creations.

Getting Started

  1. Get Your Dev Kit: Purchase your Phospho Junior Dev Kit at robots.phospho.ai. Unbox it and set it up following the instructions in the box.

  2. Control your Robot: Donwload the Meta Quest app, connect it to your robot, start teleoperating it.

  3. Record a Dataset: Record a dataset using the app. Do the same gesture 30 times to create a dataset.

  4. Install the Package:

pip install --upgrade phosphobot
  1. Train a Model: Use Le Robot to train a policy on the dataset you just recorded.
git clone https://github.com/huggingface/lerobot.git
cd lerobot
pip install -e .

Add the configs/policy/act_so100_phosphobot.yamlfile from this repository to the lerobot/configs/policy directory in the lerobot repository.

Launch the training script with the following command from the lerobot repository (change the device to cuda if you have an NVIDIA GPU or cpu if you don't have a GPU):

python lerobot/scripts/train.py \
  dataset_repo_id=YOUR_HF_DATASET_ID \
  policy=act_so100_phosphobot \
  env=so100_real \
  hydra.run.dir=outputs/train/act_so100_quickstart \
  hydra.job.name=act_so100_quickstart \
  device=mps \
  wandb.enable=false

Next steps

  • Test the model: Run the following code to test the model you just trained (TODO)
  • Join the Community: Connect with other developers and share your experience in our Discord community

Contributing

We welcome contributions from the community! Here's how you can participate:

  1. Fork this repository
  2. Create a new branch for your project
  3. Add your code and documentation
  4. Submit a Pull Request

Please ensure your code is well-documented and includes:

  • Clear setup instructions
  • Dependencies list
  • Basic usage examples
  • Any special requirements

Community Projects

Explore projects created by our community members in the code_examples directory. Each project includes its own documentation and setup instructions.

Support

License

MIT License


Made with ❤️ by the Phospho community

Project details


Release history Release notifications | RSS feed

This version

0.0.5

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

phosphobot-0.0.5.tar.gz (1.9 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

phosphobot-0.0.5-py3-none-any.whl (2.0 MB view details)

Uploaded Python 3

File details

Details for the file phosphobot-0.0.5.tar.gz.

File metadata

  • Download URL: phosphobot-0.0.5.tar.gz
  • Upload date:
  • Size: 1.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.5.26

File hashes

Hashes for phosphobot-0.0.5.tar.gz
Algorithm Hash digest
SHA256 400914ed13ea2663594e4880ab7bc2cb82964f00ab3ff52a58e0a98b6ecd14ba
MD5 51164325aa830e9b1eba472496a9b88b
BLAKE2b-256 2ca05423948b08b0efa3f509aee82169bf7583b32a42f7b43fea9c7ff2416b15

See more details on using hashes here.

File details

Details for the file phosphobot-0.0.5-py3-none-any.whl.

File metadata

  • Download URL: phosphobot-0.0.5-py3-none-any.whl
  • Upload date:
  • Size: 2.0 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.5.26

File hashes

Hashes for phosphobot-0.0.5-py3-none-any.whl
Algorithm Hash digest
SHA256 f4ea4dea2c7570dd927debad64fa59434ffc0e049aba61ac1638fe99e47143a3
MD5 ea5dac49cef796344e7cb7ff4015212c
BLAKE2b-256 47bd1e31237b7ceeeae1ba313ba978e6c760e29390cb429ad61890bb5bec596a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page