invertedai 0.0.3rc1

Client SDK for InvertedAI

InvertedAI

Overview

Inverted AI provides an API for controlling non-playable characters (NPCs) in autonomous driving simulations, available as either a REST API or a Python library built on top of it. Using the API requires an access key - contact us to get yours. This page describes how to get started quickly. For more in-depth understanding, see the API usage guide, and detailed documentation for the REST API and the Python library. To understand the underlying technology and why it's necessary for autonomous driving simulations, visit the Inverted AI website.

Get Started

Installation

For installing the Python package from PyPI:

pip install invertedai

The Python client library is open source, so you can also download it and build locally.

Minimal example

Conceptually, the API is used to establish synchronous co-simulation between your own simulator running locally on your machine and the NPC engine running on Inverted AI servers. The basic integration in Python looks like this.

import invertedai as iai

iai.add_apikey('')  # specify your key here or through the IAI_API_KEY variable

iai_simulation = iai.Simulation(  # instantiate a stateful wrapper for Inverted AI API
    location='canada:vancouver:ubc_roundabout',  # select one of available locations
    agent_count=5,  #  how many vehicles in total to use in the simulation
    ego_agent_mask=[True, False, False, False, False]  # first vehicle is ego, rest are NPCs
)
for _ in range(100):  # how many simulation steps to execute (10 steps is 1 second)
    # collect predictions for the next time step
    predicted_npc_behavior = iai_simulation.npc_states()
    # execute predictions in your simulator, using your actions for the ego vehicle
    updated_ego_agent_state = step_local_simulator(predicted_npc_behavior)
    # query the API for subsequent NPC predictions, informing it how the ego vehicle acted
    iai_simulation.step(updated_ego_agent_state)

In order to execute this code, you need to connect a simulator locally. To quickly check out how Inverted AI NPCs behave, try our Colab, where all agents are NPCs, or go to our github repository to execute it locally. When you're ready to try our NPCs with a real simulator, see the example CARLA integration. The examples are currently only provided in Python, but if you want to use the API from another language, you can use the REST API directly.