Metadata-Version: 2.4
Name: solarian-dynamixel
Version: 0.1.0
Summary: Dynamixel servo actuator and bus plugin for Solarian robotics framework
Author-email: Raul Garreta <raul@solarian.dev>
License: Apache-2.0
Classifier: License :: OSI Approved :: Apache Software License
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: solarian>=0.1.0
Requires-Dist: pyserial>=3.5
Requires-Dist: deepdiff
Provides-Extra: hardware
Requires-Dist: dynamixel-sdk>=3.7.31; extra == "hardware"
Dynamic: license-file

# Solarian-Dynamixel

Dynamixel servo actuator and bus plugin for the Solarian robotics framework.

## Installation

```bash
pip install solarian-dynamixel
```

Or install from source:

```bash
cd solarian-dynamixel
pip install -e .
```

## Usage

After installation, the plugin is automatically discovered by Solarian:

```python
from solarian.core.module import Module
from solarian.plugins import actuators

# Get the Dynamixel actuator class
DynamixelServo = actuators.get("dynamixel")

class MyArmModule(Module):
    shoulder: DynamixelServo = DynamixelServo(id=1, model="xl330-m077")
    elbow: DynamixelServo = DynamixelServo(id=2, model="xl330-m077")
```

The `DynamixelBus` is automatically used for communication - no configuration needed!

## Supported Models

- XL330 series
- XM430 series
- XH series
- Other Dynamixel servo models

## Requirements

- Solarian framework (>=0.1.0)
- dynamixel-sdk (>=3.7.31)

## Repository

This plugin should be maintained in its own repository:
- GitHub: `https://github.com/yourorg/solarian-dynamixel`
- Can be published to PyPI for easy installation

## License

[Apache License 2.0](https://github.com/solarian-dev/solarian-dynamixel/blob/main/LICENSE). Copyright 2026 PrimaryKey Inc. The driver in `solarian_dynamixel/lerobot/` is derived from [LeRobot](https://github.com/huggingface/lerobot) (Apache 2.0); see [NOTICE](https://github.com/solarian-dev/solarian-dynamixel/blob/main/NOTICE).

Solarian and the Solarian logo are trademarks of PrimaryKey Inc. See the [trademark policy](https://github.com/solarian-dev/solarian/blob/main/TRADEMARKS.md).
