Live Developer Sandbox

Try Modulus in Real Time

Interact with our physics calculation core. Run differential equations, optimization problems, and natural language physics queries.

Checking...

Try a Calculation

Enter a physics problem, differential equation, or optimization query

Natural Language Physics Query

Integration Examples

Quick start guides for integrating Modulus with your stack

Python Integration

import requests

# Health check
response = requests.get(
  "http://localhost:8000/v2/health"
)
print(response.json())

# Solve equation
response = requests.post(
  "http://localhost:8000/v2/solve",
  json={"expression": "dx/dt = -0.5x"}
)
print(response.json())

JavaScript/TypeScript

// Health check
const health = await fetch(
  'http://localhost:8000/v2/health'
)
const status = await health.json()

// Solve equation
const result = await fetch(
  'http://localhost:8000/v2/solve',
  {
    method: 'POST',
    headers: {'Content-Type': 'application/json'},
    body: JSON.stringify({
      expression: 'dx/dt = -0.5x'
    })
  }
)
const solution = await result.json()

ROS 2 Integration

# In your ROS 2 node
import rclpy
from std_msgs.msg import String
import requests

class ModulusNode(rclpy.node.Node):
    def __init__(self):
        super().__init__('modulus_node')
        self.api_url = 'http://localhost:8000'
        
    def solve_physics(self, expression):
        response = requests.post(
            f'{self.api_url}/v2/solve',
            json={'expression': expression}
        )
        return response.json()

gRPC Integration

// Coming soon
// gRPC service definitions
// for high-performance
// autonomy stack integration

service ModulusService {
  rpc SolveEquation(Expression)
    returns (Solution);
  rpc ValidateTrajectory(Path)
    returns (Validation);
}

API Endpoints

Complete reference for the Modulus calculation API

GET /v2/health

Healthy

Check backend health and available features

Response:

{
  "status": "healthy",
  "version": "2.0",
  "features": {
    "differential_equations": true,
    "optimization": true,
    "units_tracking": true,
    "algebraic_solving": true,
    "natural_language": true
  }
}

POST /v2/solve

Core

Solve differential equations, physics problems, and optimization queries

Request Body:

{
  "expression": "dx/dt = -0.5x with x(0) = 10"
}

Response:

{
  "solution": "x(t) = 10 * exp(-0.5t)",
  "steps": [...],
  "validation": {...}
}

View Full API Docs →

Ready to Integrate?

Start your pilot and get hands-on support integrating Modulus with your autonomy stack.

Start a Pilot →Learn About Pilots