Skip to main content

airo-fanuc

A standalone driver for FANUC industrial arms: a compiled real-time core speaking Stream Motion (UDP, 125 Hz / 8 ms) plus an RMI JSON client (TCP), behind a Python API.

The Python surface is split the conventional way for an industrial-arm client library: a receive half — state getters that never block, never raise, and never lie, every value carrying its age — and a control half, usable blocking or non-blocking. FanucDriver presents both on one construct-and-go object: the constructor brings the robot up to commandable or raises with a real reason, move_trajectory / move_j / servo_j are the only motion surfaces, and stop_j() is the universal preempt.

Everything timing-critical is C++: the 125 Hz tick loop, cubic-Hermite trajectory playback, the Ruckig-based brake/servo/capture profiles, the slew clip and the safety state machine. Python owns lifecycle, recovery policy, validation and the RMI session, and is never in the control loop.

One runtime dependency: numpy. Everything environment-specific is injected — the collision check, a state sink, the arm's motion envelope, the gripper's register protocol — so installing this driver does not drag in a robotics stack.


Install

pip install airo-fanuc

A download on Linux x86_64 and aarch64, CPython 3.10-3.14: the published wheels carry the compiled real-time core, so no compiler, no CMake and no headers are involved. uv add airo-fanuc / uv pip install airo-fanuc take the same wheel.

Linux only, and not a preference — the RT thread is timerfd_create + epoll + SCHED_FIFO, with no portable fallback.

Anywhere else — another platform, or a free-threaded interpreter — pip falls back to the sdist and compiles the extension, which needs a C++20 compiler, CMake ≥ 3.22, the Python development headers, and network access to fetch ruckig and pybind11.

The package ships no arm profile — you supply a RobotProfile, and most of it comes out of the controller itself. See configuration.

Will it work on your robot?

Stream Motion and RMI are FANUC's own protocols, not a collaborative-robot feature; what is required is controller option S636. The 8 ms interpolation period is an R-30iB fact, so this covers FANUC's mainstream controller class rather than only cobots.

Four things are not generic: the arm's envelope (injected, no default), the interpolation period (configured, and bring-up refuses a mismatch), the six-joint count (compile-time), and the gripper (parameterised, but its Teach-Pendant program is yours to install). Read this before planning a bring-up.

Developed and measured against a FANUC CRX-10iA/L on an R-30iB-class controller.

Usage

import numpy as np
from airo_fanuc import DriverConfig, DriverPolicy, FanucDriver, MotionResult

from crx10ial import CRX10IAL   # your arm's RobotProfile — examples/crx10ial.py

policy = DriverPolicy(config=DriverConfig(profile=CRX10IAL), enable_gripper=False)

# construct-and-go: blocks until the robot is commandable, or raises with a real reason
with FanucDriver("192.168.1.100", policy) as driver:
    q0 = np.asarray(driver.get_state()["q_cmd"], dtype=float)
    q1 = q0.copy()
    q1[5] += np.radians(10.0)                       # J6 by +10 deg

    result = driver.move_j(q1, joint_speed=0.2).wait(timeout=9.0)
    assert result == MotionResult.DONE

move_j plans a jerk-limited point-to-point profile and submits it; joint_speed is the leading-axis speed in rad/s, and every joint is time-synchronised to land together. It requires the arm to be at rest. move_trajectory(times, q, qd=None) takes a fully time-parameterised timeline instead — int64 nanoseconds, radians, velocities optional (omit them and the driver derives the knot tangents) — and the C++ core owns playback from submission, so a late Python thread costs nothing. servo_j(q, duration) is the replace-not-queue streaming path, best-effort in the sense UR's servoj is.

Every motion returns a MotionHandle immediately. .wait(timeout) blocks and resolves to a non-raising MotionResult; skip it and poll .done() / .result().

Runnable, including a --fake mode that needs no hardware:

uv run python examples/move_joints.py --fake      # single-joint rest-to-rest move
uv run python examples/sine_wave.py --fake        # dense-knot trajectory, all joints
uv run python examples/servo_stream.py --fake     # the same path streamed via servo_j

Those are also bring-up validation scripts: each reports what the controller said, moves, and ends in a PASS/FAIL verdict with the real-time loop's measured timing.

Documentation

docs/README.md is the index. The ones you are most likely to want:

License

Apache-2.0 — see LICENSE. The vendored FANUC Stream Motion codec headers are Apache-2.0 too, with no modifications (PATCHES.md). Ruckig (MIT) and pybind11 (BSD-3-Clause) are compiled into the _core extension, so the wheel redistributes both; their texts are in LICENSES/ and every component is attributed in NOTICE.

Metadata

Release files for airo-fanuc 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for airo-fanuc 0.1.0
File Size Uploaded Provenance Actions
airo_fanuc-0.1.0.tar.gz 577.1 kB With provenance Details for airo_fanuc-0.1.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for airo-fanuc 0.1.0
File Actions
airo_fanuc-0.1.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl CPython 3.14 CPython 3.14 Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64 Details for airo_fanuc-0.1.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
airo_fanuc-0.1.0-cp314-cp314-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl CPython 3.14 CPython 3.14 Linux glibc 2.26+ ARM64, Linux glibc 2.28+ ARM64 Details for airo_fanuc-0.1.0-cp314-cp314-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
airo_fanuc-0.1.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl CPython 3.13 CPython 3.13 Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64 Details for airo_fanuc-0.1.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
airo_fanuc-0.1.0-cp313-cp313-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl CPython 3.13 CPython 3.13 Linux glibc 2.26+ ARM64, Linux glibc 2.28+ ARM64 Details for airo_fanuc-0.1.0-cp313-cp313-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
airo_fanuc-0.1.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.27+ x86-64, Linux glibc 2.28+ x86-64 Details for airo_fanuc-0.1.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
airo_fanuc-0.1.0-cp312-cp312-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl CPython 3.12 CPython 3.12 Linux glibc 2.26+ ARM64, Linux glibc 2.28+ ARM64 Details for airo_fanuc-0.1.0-cp312-cp312-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
airo_fanuc-0.1.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl CPython 3.11 CPython 3.11 Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64 Details for airo_fanuc-0.1.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
airo_fanuc-0.1.0-cp311-cp311-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl CPython 3.11 CPython 3.11 Linux glibc 2.26+ ARM64, Linux glibc 2.28+ ARM64 Details for airo_fanuc-0.1.0-cp311-cp311-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
airo_fanuc-0.1.0-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl CPython 3.10 CPython 3.10 Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64 Details for airo_fanuc-0.1.0-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
airo_fanuc-0.1.0-cp310-cp310-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl CPython 3.10 CPython 3.10 Linux glibc 2.28+ ARM64, Linux glibc 2.26+ ARM64 Details for airo_fanuc-0.1.0-cp310-cp310-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl

Total release size: 5.3 MB

Release files / airo_fanuc-0.1.0.tar.gz

Download URL airo_fanuc-0.1.0.tar.gz
Size 577.1 kB
Tags Source
SHA-256 checksum
How to use checksums
a62a8d44e381cfa697424bb7c808320a749ce80218264a7364447d372dd11ce0
BLAKE2b-256 checksum
How to use checksums
ca3216a5b63c81d27058e3f8995dd65dbf77c62c594e60b74174a19759c1b27e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 4, 2026.

Transparency log

Release files / airo_fanuc-0.1.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL airo_fanuc-0.1.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 486.8 kB
Tags CPython 3.14 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
659b1645469e9995b3aa2045697f67184c8bb779487b6f349fd8fab21918f7f6
BLAKE2b-256 checksum
How to use checksums
3ecad43b55a42d8aa5de744c0c834b73beb6f4e3a70d62760b5ff2849a8928d4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 4, 2026.

Transparency log

Release files / airo_fanuc-0.1.0-cp314-cp314-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl

Download URL airo_fanuc-0.1.0-cp314-cp314-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
Size 454.2 kB
Tags CPython 3.14 Linux glibc 2.26+ ARM64 Linux glibc 2.28+ ARM64
SHA-256 checksum
How to use checksums
b7144fd649c39d3460ed9f0ea7f7fd4c042edf6583d630e3c7339d3980a555ad
BLAKE2b-256 checksum
How to use checksums
06762eb5426c1727d502d1a3f88741629b483998c45680ceed8e323920063546
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 4, 2026.

Transparency log

Release files / airo_fanuc-0.1.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL airo_fanuc-0.1.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 486.7 kB
Tags CPython 3.13 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
ddcaa1225dd2d01a9aa13659a2e73e97ff3d2b8d438a24b17b65ec85a81ea402
BLAKE2b-256 checksum
How to use checksums
256a9bbe5cee27461efa0d6fab0e5ae0e7a1b9183aa0196a1c34c80ae4db9fcb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 4, 2026.

Transparency log

Release files / airo_fanuc-0.1.0-cp313-cp313-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl

Download URL airo_fanuc-0.1.0-cp313-cp313-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
Size 453.4 kB
Tags CPython 3.13 Linux glibc 2.26+ ARM64 Linux glibc 2.28+ ARM64
SHA-256 checksum
How to use checksums
a127aa720cc05319370127b6c4659c8774337397e5f2b864c04620ff95b4e7f7
BLAKE2b-256 checksum
How to use checksums
8c1d9a61bbe7e05a1ad4dc9a93372c83a8e062870bd86e31cdec0d581f4c746d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 4, 2026.

Transparency log

Release files / airo_fanuc-0.1.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL airo_fanuc-0.1.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 486.9 kB
Tags CPython 3.12 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
e8417f2492d2ed55cbd6a2224cc598a7c5893ad9c499359dad9853b6b140c37e
BLAKE2b-256 checksum
How to use checksums
9b3906a598e20ca8092985d0b45c80e1f2a8c3e0e1c1a63eae75168e096f8479
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 4, 2026.

Transparency log

Release files / airo_fanuc-0.1.0-cp312-cp312-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl

Download URL airo_fanuc-0.1.0-cp312-cp312-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
Size 453.3 kB
Tags CPython 3.12 Linux glibc 2.26+ ARM64 Linux glibc 2.28+ ARM64
SHA-256 checksum
How to use checksums
59384985eacfbaf883c3cf83e37f30eae10130890186d79a1ce3afa4ee802651
BLAKE2b-256 checksum
How to use checksums
09c44f9bb1ea95d88d8a20538a0d8587c700d2986829a4253491a11794958461
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 4, 2026.

Transparency log

Release files / airo_fanuc-0.1.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL airo_fanuc-0.1.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 485.2 kB
Tags CPython 3.11 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
5abc8847926dce524f8bda85d3a7fba353908f553013808fa82ba7b64d3d5a0a
BLAKE2b-256 checksum
How to use checksums
e7801b624eebd1d7e4292ac5b4f3b6d4232731ee25c782c3c09322ef0098eef4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 4, 2026.

Transparency log

Release files / airo_fanuc-0.1.0-cp311-cp311-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl

Download URL airo_fanuc-0.1.0-cp311-cp311-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
Size 453.5 kB
Tags CPython 3.11 Linux glibc 2.26+ ARM64 Linux glibc 2.28+ ARM64
SHA-256 checksum
How to use checksums
5a768fd8b64951bde9ca901ec3413bc10564dbc7194bf408d80e6dd43bc9c1d0
BLAKE2b-256 checksum
How to use checksums
f9fcd4d76afa1b41a8b60db9a75680086caedbc66a35e4aad45cc00647d562ac
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 4, 2026.

Transparency log

Release files / airo_fanuc-0.1.0-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL airo_fanuc-0.1.0-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 484.2 kB
Tags CPython 3.10 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
488c3519edf99384e2cb9e0780cc84c18e2014029a7dcf4b64cd8b58d622fb5b
BLAKE2b-256 checksum
How to use checksums
a7b12f1e222c2b56f49882616ffc9e541bc09852fb479124191993253bf35f2b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 4, 2026.

Transparency log

Release files / airo_fanuc-0.1.0-cp310-cp310-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl

Download URL airo_fanuc-0.1.0-cp310-cp310-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
Size 452.6 kB
Tags CPython 3.10 Linux glibc 2.26+ ARM64 Linux glibc 2.28+ ARM64
SHA-256 checksum
How to use checksums
eb5d59598fe9e3792347e2518cfcc3a5b023e7439e1c64eab4762963591c26f4
BLAKE2b-256 checksum
How to use checksums
bb7a745bfbe6b19ed4da5b3ac5fa516492f4a8b1744e50f5f4911bb7cb39068d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 4, 2026.

Transparency log

Security for airo-fanuc 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 11 files in this release have been uploaded with provenance metadata.

Select from 11 files

Attestation for airo_fanuc-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 4, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

11 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page