Skip to main content

Documentation Index

Fetch the complete documentation index at: https://usenaive.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
CLI First

# Install and register
npm install -g @usenaive-sdk/cli
naive register --name "My Agent" --email owner@example.com --password securepassword123

# First primitive call
naive search "latest AI agent frameworks"

​
Give This to Any AI Agent

Paste the following prompt into any AI agent (Claude, ChatGPT, Cursor, etc.) and it will set up Naive autonomously: 
I want you to follow https://api.usenaive.ai/skill.md and setup naive
That’s it. The agent will read the skill manifest, register an account, and start using primitives.

​
Manual Setup

If you prefer to set things up yourself, this walks through creating an agent account, getting an API key, and making your first API call. Five minutes, end to end.
1

Register your agent

Create an account with an email and password. You’ll get back an API key immediately.
curl -X POST https://api.usenaive.ai/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Research Agent",
    "email": "owner@example.com",
    "password": "securepassword123",
    "company_name": "Acme Corp"
  }'
Response:
{
  "api_key": "nv_sk_live_abc123...",
  "agent_id": "uuid",
  "company_id": "uuid",
  "company_name": "Acme Corp",
  "domain": "acme-corp.usenaive.ai",
  "domain_status": "pending_dns",
  "hint": "Key saved. System domain auto-provisioned (pending_dns until verified). Check GET /v1/domains."
}
Copy your API key immediately — it’s only shown once.
2

Check your identity

Verify everything is wired up correctly:
curl https://api.usenaive.ai/v1/identity \
  -H "Authorization: Bearer nv_sk_live_abc123..."
This shows your agent profile, company, email inboxes, domains, and credit balance.
3

Make your first call

curl -X POST https://api.usenaive.ai/v1/search \
  -H "Authorization: Bearer nv_sk_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{ "query": "latest AI agent frameworks 2026" }'
Response:
{
  "results": [
    { "title": "Top AI Frameworks 2026", "url": "https://...", "snippet": "..." }
  ],
  "credits_used": 1,
  "credits_remaining": 99
}

​
Using the CLI

# Install
npm install -g @usenaive-sdk/cli

# Register (saves key automatically)
naive register --name "My Agent" --email owner@example.com --password mypassword123

# Verify connectivity
naive status

# Your first search
naive search "latest AI agent frameworks"

​
Using MCP (Claude Desktop / Cursor)

Connect via SSE — no local installation required: 
{
  "mcpServers": {
    "naive": {
      "url": "https://api.usenaive.ai/mcp/sse",
      "headers": {
        "Authorization": "Bearer nv_sk_live_..."
      }
    }
  }
}
The MCP server is hosted — the agent runtime connects directly over SSE. No local server, no ports, just the API key.

​
Agent Discovery

Any agent can fetch https://api.usenaive.ai/skill.md to discover all capabilities and onboard autonomously. Point your agent there and it will know how to register, authenticate, and use every primitive.

​
What’s Available

Once connected, your agent has access to all Phase 1 primitives:
Try thisWhat happens
Search the webPOST /v1/search — real-time web results
Send an emailPOST /v1/email/send — from your provisioned inbox
Generate imagesPOST /v1/images/generate — using FLUX/Recraft models
Generate videoPOST /v1/video/generate — using Kling/Minimax models
Deep researchPOST /v1/search/research — multi-source synthesis

​
Local Development (Contributors)

To run the full orchestration stack locally (CEO agent, task dispatch, employee workers):
1

Prerequisites

# Install Hermes agent
pip install "hermes-agent[mcp]"

# Install dependencies
pnpm install

# Start the API
cd packages/api && pnpm dev
2

Start the container

The dev container script only needs your company ID. It auto-creates a dev API key and uses a static auth token so restarts don’t break authentication.
# Find your company ID
psql $DATABASE_URL -c "SELECT id, name FROM companies;"

# Start the container
poetry run ./scripts/dev-container.sh <COMPANY_ID>
This starts the sidecar on :3100, the Hermes gateway on :8642, and registers the container in the database so the API can discover it.
3

Start the Studio

cd packages/studio && pnpm dev
Open http://localhost:3000 to access the Studio UI with CEO chat, task board, and team management.
The dev container uses a deterministic auth token (nv_ct_dev_static_local_token) so you can restart processes, edit code, and the auth stays consistent. No need to pass API keys — one is auto-created in the database.

​
Next Steps

Authentication

Key format, linking existing accounts, company selection

Credits

How billing works — sync vs async, dynamic pricing

Email

Create inboxes and send identity-aware emails

Images

Generate AI images or search free stock photos