# Novo Agents > The complete agent behind one API. Your product calls one API; a frontier-grade agent does the work: browser, documents, web research, media, and human-in-the-loop included, contained in your infrastructure, metered per run. Facts for coding agents: install `novoagents` (server-only; browser construction throws `browser_runtime`); auth via the `NOVO_AGENTS_API_KEY` env var (keys start `novo_ag_`); API base `https://api.novoagents.ai`; a run is finished at the `data-novo-terminal` chunk, not stream EOF (`streamToCompletion()` reconnects until it arrives). Guided setup: https://novoagents.ai/setup.md ## Get started - [Quickstart](https://novoagents.ai/docs/index.md): Key, install, hello world, and the streaming pattern you ship. - [Set up with your coding agent](https://novoagents.ai/setup.md): One markdown file your coding agent follows to wire Novo in end to end. - [Authentication](https://novoagents.ai/docs/authentication.md): Bearer API keys (novo_ag_…), rotation, and server-only rules. ## Concepts - [Agents, threads, runs](https://novoagents.ai/docs/concepts/agents-threads-runs.md): The three nouns: saved config, one conversation, one turn of work. - [Context](https://novoagents.ai/docs/concepts/context.md): Durable context blocks on the agent, thread framing, and per-run input. - [Capabilities](https://novoagents.ai/docs/concepts/capabilities.md): Every switchable ability: web, browser, media, GitHub, MCP, bands, strict data handling. - [Human in the loop](https://novoagents.ai/docs/concepts/human-in-the-loop.md): Pause for approvals or questions, resolve with one call, steer mid-run. - [Subagents](https://novoagents.ai/docs/concepts/subagents.md): How one run delegates: orchestrator, advisors, workers, and task cards. - [Streaming](https://novoagents.ai/docs/concepts/streaming.md): The SSE wire protocol: UIMessageChunks, data-novo-* extensions, reconnect. - [Pre-warming](https://novoagents.ai/docs/concepts/pre-warming.md): Cut cold-start latency with threads.prewarm() before the first run. - [Adapters](https://novoagents.ai/docs/concepts/adapters.md): Signed extension points where Novo calls your infrastructure. ## Managed capabilities - [Overview](https://novoagents.ai/docs/concepts/managed-capabilities.md): Capabilities Novo operates end to end, with nothing for you to host. - [Browser](https://novoagents.ai/docs/concepts/managed-browser.md): A hosted deterministic browser the agent drives by accessibility snapshot. - [Media editing](https://novoagents.ai/docs/concepts/managed-capabilities/media-editing.md): Crop, resize, convert, trim, and transcode real workspace files. - [Workspace](https://novoagents.ai/docs/concepts/workspaces.md): Managed or remote filesystem + shell, documents, previews, and limits. ## Build - [Embed stories](https://novoagents.ai/docs/embed-stories.md): Three shipped shapes: the support agent, the deploy-proof research copilot, the metered agent you resell. - [Stream into a Next.js route](https://novoagents.ai/docs/guides/stream-into-a-next-route.md): Proxy the run stream to your frontend with stream.toResponse(). - [Stream into an Express route](https://novoagents.ai/docs/guides/stream-into-an-express-route.md): Bridge the Web Response into Node: headers, piping, compression traps. - [Reconnect a dropped stream](https://novoagents.ai/docs/guides/reconnect-a-dropped-stream.md): Resume with Last-Event-Id; completion is the terminal chunk, not EOF. - [Build a tool approval hook](https://novoagents.ai/docs/guides/build-a-tool-approval-hook.md): Review consequential tool calls from your endpoint before they execute. - [Render a human review inbox](https://novoagents.ai/docs/guides/render-a-human-review-inbox.md): Group, expire, and batch-resolve approvals and questions safely. - [Build a React run UI](https://novoagents.ai/docs/guides/build-a-react-run-ui.md): Headless useNovoRun/useNovoInteractions hooks over your proxy routes, with no protocol code. - [Troubleshooting](https://novoagents.ai/docs/troubleshooting.md): Symptom-first fixes: EOF vs terminal, 401s, thread_busy, stuck pauses, cost reconciliation. ## Trust - [Data flow & containment](https://novoagents.ai/docs/concepts/data-flow.md): What runs where, what crosses signed, and the canonical strict data handling definition. - [Security overview](https://novoagents.ai/security): The containment architecture in plain language, for security reviews. - [Security policy](https://novoindustries.co/legal/novo-agents/security): The binding security policy (Novo Industries legal). - [Subprocessors](https://novoindustries.co/legal/novo-agents/subprocessors): The authoritative subprocessor list (Novo Industries legal). ## API reference - [Agents](https://novoagents.ai/docs/api/agents.md): Create, update, and configure agents, with the full config schema. - [Threads](https://novoagents.ai/docs/api/threads.md): Conversations: create, stream, prewarm, timezone, delete. - [Runs](https://novoagents.ai/docs/api/runs.md): Start, stream, inspect, and cancel runs; budgets and terminal reasons. - [Files](https://novoagents.ai/docs/api/files.md): Stage inputs and attach them to runs by fileId. - [Browser sessions](https://novoagents.ai/docs/api/browser-sessions.md): Inspect and manage managed browser sessions. - [Artifacts](https://novoagents.ai/docs/api/artifacts.md): Retention-scoped output handles and durable export. - [Environments](https://novoagents.ai/docs/api/environments.md): Register your own http_workspace runtime so tools run on your side. - [Result handlers](https://novoagents.ai/docs/api/result-handlers.md): Signed callbacks that receive deliverables into your storage. - [Secrets](https://novoagents.ai/docs/api/secrets.md): Encrypted values projected only where you grant them. - [Secret contexts](https://novoagents.ai/docs/api/secret-contexts.md): Reusable secret bundles injected as workspace env. - [GitHub connections](https://novoagents.ai/docs/api/github-connections.md): First-party GitHub workflow; credentials never enter the workspace. - [Tool servers](https://novoagents.ai/docs/api/tool-servers.md): Attach your MCP servers as mcp__* tools. - [HTTP connections](https://novoagents.ai/docs/api/http-connections.md): Attach OpenAPI/HTTP endpoints as api__* tools. - [Tool approval hooks](https://novoagents.ai/docs/api/tool-approval-hooks.md): Register the endpoint that reviews tool calls pre-execution. - [Interactions](https://novoagents.ai/docs/api/interactions.md): Resolve paused approval requests and questions. - [Usage](https://novoagents.ai/docs/api/usage.md): Aggregated usage and exact ledger rows, grouped for pass-through. - [Credits](https://novoagents.ai/docs/api/credits.md): Wallet balance and account limits. - [Bands](https://novoagents.ai/docs/api/bands.md): The live catalog of offered bands and strict-route availability. ## Reference - [Signed callbacks](https://novoagents.ai/docs/webhooks.md): Verify Novo-Signature on every outbound call to your endpoints. - [Errors](https://novoagents.ai/docs/errors.md): Error envelope, SDK subclasses, codes, and terminal reasons. - [Pricing](https://novoagents.ai/pricing): Metered per run: band token rates, managed tools, budgets, credits. - [Changelog](https://novoagents.ai/docs/changelog.md): SDK and API release notes.