For Developers

introduction to developing on Ratio1

For Developers

This chapter is the developer operating layer for Ratio1: SDK workflows, tutorials, API entry points, runtime context, and CLI-based fleet operations.

Choose your path

• Python SDK: fastest path for custom workloads, plugin orchestration, and native Ratio1 app logic (including apps with containerized front-end/middle-tier layers).
• JavaScript / Go SDKs: language-native integration surfaces for teams outside Python.
• Sandbox workflows: local and controlled experimentation before wider rollout.
• r1ctl CLI: kubectl-like command-line control for managing Ratio1 decentralized fleets, nodes, and diagnostics.

Developer workflow vs production workflow

• Developer workflow: iterate with SDK/CLI, test callbacks and pipeline behavior, validate assumptions.
• Production workflow: run managed delivery through Deeploy UI/API on licensed infrastructure.
• Operational split: use deeploy.ratio1.ai for deployment operations, app.ratio1.ai for license/account flows, and explorer.ratio1.ai for telemetry.
• Cross-reference: use Ratio1 Overview for orchestration/economics/runtime architecture.

In this section

• Python
• JavaScript
• Go
• Sandbox
• r1ctl
• Donation add-on for developers

Ground truth references

Primary:

• https://github.com/Ratio1/ratio1_sdk
• https://pypi.org/project/ratio1/
• https://ratio1.ai/whitepaper

Supporting:

• https://ratio1.ai/blog/ratio1-sdk-for-typescript-your-bridge-to-edge-nodes
• https://ratio1.ai/blog/go-developers-meet-the-new-ratio1-sdk-and-sandbox
• https://ratio1.ai/blog/empowering-the-nodejs-ecosystem
• https://deeploy.ratio1.ai/
• https://app.ratio1.ai/
• https://explorer.ratio1.ai/

Notable date

• Reviewed on February 18, 2026.