GiuliaAPI

Radio network simulation tools for AI agents.

Get API Access Documentation

Soon. For now, use the public demo deployment while access keys are being prepared.

Endpoints

Use REST for direct HTTP control.

REST API
https://nicopi-giuliaapi.hf.space/api

Or connect your favorite AI agents directly to the MCP endpoint.

MCP
https://nicopi-giuliaapi.hf.space/mcp
Python quickstart Open in Colab 
import requests

base = "https://nicopi-giuliaapi.hf.space"
headers = {
    "X-API-Key": "your-api-key",
}

# Create a simulation in your API-key workspace.
sim = requests.post(f"{base}/api/create_simulation", headers=headers, json={
    "scenario_model": "ITU_R_M2135_UMa",
    "ue_distribution": "uniform",
    "link_direction": "downlink",
    "number_of_episodes": 1,
}).json()

# Run the latest simulation in that workspace.
requests.post(f"{base}/api/run_simulation", headers=headers)

# Read aggregated results from the latest simulation.
results = requests.post(f"{base}/api/get_aggregated_results", headers=headers, json={
    "kpis": ["ue_throughput_Mbps"],
    "group_by": "all",
    "metrics": ["mean"],
}).json()

mean_throughput = results["data"]["ue_throughput_Mbps"]["all"]["mean"]
print(f"Mean UE throughput is {mean_throughput:.2f} Mbps")