NavaiaForge Guide

How NavaiaForge works

NavaiaForge lets you build, run, and sell AI workforces — teams of agents that operate together. Use the UI, the SDK, or thenavaia-codeCLI. Whichever you pick, the workforces show up in one place: here.

1. Build a workforce

A workforce is a graph of agentsand the edges that connect them. Each agent has a role, a model, a system prompt, and a tool list. Edges decide who hands off to whom and when. Build one of three ways:

In the UI — drag agents on the Canvas, wire them up, hit Run.
With the navaia-forge-sdk (Python + TypeScript) — ideal for repeatable, code-reviewed agent definitions.
With navaia-code — a local CLI where you can iterate fast, then push the workforce up to the platform.

2. Pick a runtime

Every workforce runs against a runtime — the engine that actually executes agent steps. You pick one when the workforce is created (or in its Settings tab).

Claude CodeDefault

Anthropic's Claude CLI on your machine or our default cluster. Best for general coding/orchestration work.

Navaia Code — LocalSelf-hosted

Run the navaia-code CLI on your own machine. Multi-provider (OpenRouter, Anthropic, OpenAI, local Ollama). You keep full control of your keys and data.

Navaia Code — HostedBy request

Same engine as Local, but running on Navaia's managed infra. You don't need a CLI installed. Access is gated: submit a hosting request and we'll review it. Request access.

3. Connect from code

The SDK and the navaia-code CLI both authenticate with an API key tied to your account. Generate one in Settings → API Keys, then:

# Python SDK
from navaia_forge import NavaiaForgeClient
client = NavaiaForgeClient(
    base_url="https://api.navaia.sa",
    api_key="nf_…",   # from Settings → API Keys
)
for wf in client.workforces.list():
    print(wf.name, wf.runtime_mode)

# navaia-code CLI
export NAVAIA_API_KEY=nf_…
navaia push --workforce my-crew

Workforces created via the SDK or pushed from navaia-code appear in Workforces with a badge so you can tell at a glance where each one came from.

4. Publish & sell

When a workforce is ready for others, publish it to the Marketplace. You set a price, tagline, and category. Navaia brokers the sale — buyers contact us, we collect, you get paid out. Listings are reviewed by an admin before they go public.

5. Safety & quotas

Each user has a per-account concurrency cap so one workspace cannot starve another.
Marketplace publish and install endpoints are rate-limited (30 requests / hour per user).
API keys are hashed at rest. Revoke any key instantly from Settings.
Hosted-runtime access is one-workforce-at-a-time and revocable — you stay in control.