AERONTRAIntelligence Beyond Flight
AERONTRA / DEVELOPER PLATFORM

Build beyond
the interface.

One API contract. Familiar tools. Clear boundaries.
Integrate aerospace source discovery into your own workflow.

Open API specificationGet started
FOUNDATION RELEASE · v0.1.0 · SDKs ARE SOURCE-INSTALL ONLY
START HERE

A working contract, honest about readiness.

The source-discovery preview is available locally. There is no public production API hostname, paid API key program, or active model inference endpoint. Obtain an Entra API access token from your configured tenant for authenticated use. Local demo mode is for loopback development only.

01

Run the platform

Follow the repository README to start the local API and web preview.

02

Configure identity

Use your API audience and issued access token. Never use an ID token as an API credential.

03

Choose a client

REST, Python, TypeScript, CLI, or local MCP. All follow the same API authorization.

ONE CONTRACT / YOUR LANGUAGE

Aerontra SDKs

Choose a language to see its actual availability and installation path. All clients use the same API authorization.

Available from source

Python

For research notebooks, data workflows, automation, and Python applications.

uv pip install ./packages/sdk-python

from aerontra_sdk import AerontraClient

with AerontraClient(base_url=api_url, token=token) as api:
    result = api.research_preview("satellite orbit", "Space")
Packages are currently source-install previews, not published registry packages. Native MATLAB, Julia, Rust, and C++ clients can be evaluated when customer workflows justify them; REST access does not depend on a native SDK.

REST API

OPENAPI 3.1

Use the versioned API directly. Entra access tokens carry your identity; the API validates roles and organization membership.

curl "$AERONTRA_API_URL/v1/sources" \
  -H "Authorization: Bearer $AERONTRA_TOKEN"

Python SDK

SOURCE PREVIEW

A synchronous client with explicit timeouts, authenticated requests, structured API errors, and context-manager cleanup.

uv pip install ./packages/sdk-python

from aerontra_sdk import AerontraClient

with AerontraClient(base_url=api_url, token=token) as client:
    result = client.research_preview(
        "airport climate resilience", domain="Climate"
    )

TypeScript SDK

SOURCE PREVIEW

An ESM fetch client for trusted applications. Keep long-lived credentials on your server, never in client bundles.

npm run build:sdk

import { AerontraClient } from '@aerontra/sdk';

const client = new AerontraClient({ baseUrl, token });
const sources = await client.sources();
const models = await client.models();

Developer CLI

PYTHON PACKAGE

Inspect identity, sources, references, planned models, and directory-search results from a terminal. Tokens come from the environment or standard input.

# Install the Python SDK from this repository first.
export AERONTRA_API_URL="http://127.0.0.1:8002"
# Set AERONTRA_TOKEN securely; do not paste it into source.
aerontra me
aerontra sources
aerontra research "satellite orbit" --domain Space

MCP server

LOCAL STDIO

Connect compatible developer clients to read-only Aerontra tools. The adapter calls the authorized API and does not bypass access checks.

uv sync --project integrations/mcp
# Set AERONTRA_API_URL and AERONTRA_TOKEN securely.
uv run --project integrations/mcp \
  python integrations/mcp/server.py

# Tools: list_sources, list_models, research_directory
VERSIONED INTERFACES

The supported customer endpoints.

GET/healthz

Public API process health

GET/v1/me

Validated identity and roles

GET/v1/sources

Source candidates and licensing state

GET/v1/references

Source-directory references

POST/v1/research/preview

Directory matching; no AI synthesis

GET/v1/models

Planned model cards; no inference

Predictable failures. Clear limits.

401Missing or invalid access token. Sign in again; do not retry with an ID token.
403Valid identity with insufficient role, organization membership, or data rights.
409The resource changed or an operation conflicts with current state. Refresh before retrying.
422Invalid input. Inspect the API validation details and correct the request.
503A dependency or integration is unavailable. Disabled billing and email delivery fail closed.

Clients use bounded timeouts and do not automatically retry writes. SDKs do not log tokens. Idempotency, commercial rate limits, metering, and public API-key issuance are planned for the API Management milestone.

Integration roadmap

Remote authenticated MCP, asynchronous research jobs, webhooks, service-to-service identities, connectors, usage dashboards, API Management quotas, and model inference are planned. They require Azure configuration, persistent workflow state, and versioned contracts before release.

Explore model direction

Report a security issue

We welcome reports from researchers acting in good faith. Only test accounts and data you own or have permission to use. If you encounter anyone else’s data, stop and tell us, and do not keep, share, or change it. Avoid service disruption, spam, and social engineering, and give us reasonable time to fix an issue before making it public.

If you follow these guidelines, we will treat your research as authorized and will not pursue legal action against you for it. This does not cover activity that breaks the law or affects third parties. Aerontra does not currently offer a paid bug bounty.

Send a description, steps to reproduce, and likely impact to Aerontra, Attn: Security, 2100 E Grand Ave, 1st Floor, El Segundo, CA 90245.