Python Agent
The Python Agent package lets you build Paranet actors in pure Python while Paraflow code is generated for you behind the scenes. Python actors are ideal when you:
- prototype a new Paranet skill quickly,
- want to wrap an existing Python service (e.g., ROS, OpenCV, a REST micro‑service) so that it can participate on the Paranet, or
- integrate with simulation environments—such as NVIDIA Omniverse Isaac Sim—that already expose rich Python APIs.
Installation
pip install paranet_agent
When using this in Isaac Sim, remember that you need to install it within the Python environment bundled with Isaac Sim.
Usage
Once registered, every Python actor is treated exactly like any Paraflow actor:
it advertises skills, receives PnCP requests, benefits from Negative‑Trust‑Security (NTS) certificates that are issued automatically, and can be observed, audited, and orchestrated by any other node that is affiliated with yours.
Example actors (including those used in the Isaac Sim kits) live in the examples/ folder of the GitHub repo.
Implementing an actor with the Python Agent package involves creating a class that defines the actor's behavior and the data types used by that actor (e.g. input/output types). The types, actor class and actor class methods are annotated with Python decorators to declare how they map to Paranet concepts like actor, skill request, etc.
Once you've implemented your actors, you need to implement these steps in order
- register the actors
- start the agent runtime
- deploy the actors
See the hello_python project for a complete example.
Learning More
| API | Purpose | Where to Learn More |
|---|---|---|
| Decorators | Define an an actor's types, skills and requests | Decorators |
| Conversations | Managing the conversations of long-running skills | Conversation Class |
| Actor | Making Paranet requests | Actor Class |
| Registration | Making Paranet requests | Registration |
| Agent Runtime | Making Paranet requests | Connector |
| Deployment | Making Paranet requests | Deployment |