Skip to main content

A Python library for controlling AlphaDog robotic dogs

Project description

robodog

A Python library for controlling AlphaDog robotic dogs.

Features

  • Automated ROS connection management
  • Multiple control modes (standing, walking, dancing, etc.)
  • Real-time status monitoring
  • Dynamic parameter configuration
  • Elegant context manager support
  • Comprehensive error handling
  • Type annotation support

Installation

pip install robodog

Quick Start

  1. Ensure your computer is on the same network as the robotic dog
  2. Note the IP address of the robotic dog (default: 10.10.10.10)

Basic Example

from robodog import Dog
from robodog.config import UserMode
import time

# Connect to the dog using default IP
with Dog() as dog:
    # Switch to normal mode
    dog.set_user_mode(UserMode.NORMAL)
    
    # Adjust standing height
    dog.set_parameters({'body_height': 0.25})
    time.sleep(2)
    
    # Restore default height
    dog.set_parameters({'body_height': 0.23})

Core Features

  • Switch between user modes (normal, quiet, kids, etc.)
  • Adjust body posture (height, tilt, etc.)
  • Real-time status monitoring

Check the examples directory for more examples.

User Modes

Available user modes:

  • UserMode.NORMAL: Normal mode
  • UserMode.QUIET: Quiet mode
  • UserMode.KIDS: Kids mode
  • UserMode.EXTREME: Extreme mode
  • UserMode.DANCE: Dance mode
  • UserMode.MUTE: Mute mode
  • UserMode.LONG_ENDURANCE: Long endurance mode

Basic parameters:

  • body_height: Body height (default 0.23)
  • roll: Roll angle
  • pitch: Pitch angle
  • yaw: Yaw angle

Contributing

Issues and pull requests are welcome. For major changes, please open an issue first to discuss proposed changes.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contact

For questions or suggestions:

Project details


Download files

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

Source Distribution

robodog-0.1.1.1.tar.gz (9.7 kB view details)

Uploaded Source

Built Distribution

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

robodog-0.1.1.1-py3-none-any.whl (10.1 kB view details)

Uploaded Python 3

File details

Details for the file robodog-0.1.1.1.tar.gz.

File metadata

  • Download URL: robodog-0.1.1.1.tar.gz
  • Upload date:
  • Size: 9.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.9.21

File hashes

Hashes for robodog-0.1.1.1.tar.gz
Algorithm Hash digest
SHA256 a9caa4876d313bd42abbf6cb53d929194c5afba5d15901a86911d88adae6ace9
MD5 a73122cf2e65b4fc28e8745c5944459f
BLAKE2b-256 738cf1131679d2609333817e7cc89b2ae4252d8fe34a131cff777f4531e033d8

See more details on using hashes here.

File details

Details for the file robodog-0.1.1.1-py3-none-any.whl.

File metadata

  • Download URL: robodog-0.1.1.1-py3-none-any.whl
  • Upload date:
  • Size: 10.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.9.21

File hashes

Hashes for robodog-0.1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8ffa358129621c058202c7992f6adbafd94f4f72550dc1503a7770742477e6a2
MD5 63e9af67e78a3e2d7ead3095bb6e03c2
BLAKE2b-256 144aae0a775330c0cb6933d8f5983ab2496f34a0ca51019089e95e5a7331b369

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