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.7

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.7.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.7-py3-none-any.whl (2.0 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: phosphobot-0.0.7.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.7.tar.gz
Algorithm Hash digest
SHA256 499910701a57f30173266f94b54a8c6d5c9f05169e407efe894a08c4300d88fb
MD5 74f94aa5b7968d77027bc1b68f9164eb
BLAKE2b-256 a904257aafb0a3bf516393c494bdba1de717be22aab68efb930e5f7cfa22b26d

See more details on using hashes here.

File details

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

File metadata

  • Download URL: phosphobot-0.0.7-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.7-py3-none-any.whl
Algorithm Hash digest
SHA256 9b62e65cfb28664e93f0f388531e6b5caad66982e56b33fcc09f41fa1e98c9f1
MD5 f2ad1b2a03b1b202b7c8343efa453497
BLAKE2b-256 11502f0145faa9228f12e872e53a0292861029691f79c8286f046fb06d2e2525

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