orca-core

Orca Core is the core control package of the ORCA Hand. It's used to abstract hardware, provide scripts for calibration, tensioning and to control the hand with simple high-level control methods in joint space.

Get Started

To get started with Orca Core, follow these steps:

Sync a local development environment with uv:
```
uv sync --group dev
```
This creates a local .venv and installs the package plus development dependencies.
Run commands through uv:
```
uv run pytest
```
If you prefer an activated shell, you can still use:
```
source .venv/bin/activate
```
End users who do not use uv can still install the package with:
```
pip install .
```
Check the configuration file:
- Review the config file (e.g., orca_core/models/v2/orcahand-right/config.yaml) and make sure it matches your hardware setup.

Run the tension and calibration scripts:

uv run python scripts/tension.py orca_core/models/v2/orcahand-right/config.yaml
uv run python scripts/calibrate.py orca_core/models/v2/orcahand-right/config.yaml

Replace the path with your specific hand model folder if needed.

Move the hand to the neutral position:

uv run python scripts/neutral.py orca_core/models/v2/orcahand-right/config.yaml

Troubleshooting

Serial Port Permissions (Linux)

On Linux, the serial port (e.g., /dev/ttyACM0) is owned by the dialout group. If your user is not in this group, you will get a permission denied error and motors won't be detected.

Permanent fix (requires re-login):

sudo usermod -aG dialout $USER

Temporary fix (resets on reboot/replug):

sudo chmod 666 /dev/ttyACM0

Serial port, baudrate, and motor type

By default these are all auto-detected at connect time.

However, you can declare them explicitly in config.yaml. Useful when:

multiple hands are connected at once → port disambiguates which one
motors run at a non-default baudrate → baudrate skips the probe sweep
the auto-detection picks the wrong family → motor_type forces a specific one

# Optional overrides:   auto-detected if omitted
port: /dev/ttyACM0      # or /dev/cu.usbmodemXXXX on macOS
baudrate: 1000000       # 1M for v2; 3M for v1
motor_type: dynamixel   # or 'feetech'

Download files

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

Source Distribution

orca_core-0.4.1.tar.gz (408.9 kB view details)

Uploaded Aug 18, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

orca_core-0.4.1-py3-none-any.whl (196.7 kB view details)

Uploaded Aug 18, 2026 Python 3

File details

Details for the file orca_core-0.4.1.tar.gz.

File metadata

Download URL: orca_core-0.4.1.tar.gz
Upload date: Aug 18, 2026
Size: 408.9 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for orca_core-0.4.1.tar.gz
Algorithm	Hash digest
SHA256	`b5b5332887939740638468391433cc104a83098396a4c3e2c72156495e2481bb`
MD5	`5070f7c50010089770e12a94af3f848a`
BLAKE2b-256	`4a1faf08ecbd580aa3cce6b72dc1d5788683a5928fe085f2054905fdc3bb62c6`

See more details on using hashes here.

Provenance

The following attestation bundles were made for orca_core-0.4.1.tar.gz:

Publisher: release.yml on orcahand/orca_core

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: orca_core-0.4.1.tar.gz
- Subject digest: b5b5332887939740638468391433cc104a83098396a4c3e2c72156495e2481bb
- Sigstore transparency entry: 2506629476
- Sigstore integration time: Aug 18, 2026
Source repository:
- Permalink: orcahand/orca_core@c783006ee65432bd0155708cedc685d074448c65
- Branch / Tag: refs/heads/main
- Owner: https://github.com/orcahand
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@c783006ee65432bd0155708cedc685d074448c65
- Trigger Event: push