Novgraph Sovereign

Your codebase stays on your device and works locally.

Setup / From your codebase

uv tool install novaya
novgraph install sovereign
novgraph pair

Your codebase stays on your device.

Use Novgraph with a proprietary repository without connecting it to our hosted backend. Indexing, graph storage, queries and recorded reasoning run locally, with no silent fallback to Novaya.

Local checkout indexing and Git history

Symbols, dependencies and ranked change impact

Local search, summaries and reasoning write-back

The same novgraph commands and MCP tools

Your hosted dashboard reads the paired local graph

Explicit hosted or sovereign mode selection

Sovereign is included in Free, Plus and Pro. Hosted and local calls share one allowance: 1,000 on Free, 25,000 on Plus and 100,000 on Pro every 30 days. Your coding agent's model connection remains its choice.

Set up Sovereign →

Frequently asked questions

What is Novgraph Sovereign?

Novgraph Sovereign runs a knowledge graph of your repository on your device. It connects code structure, architecture, change history and recorded reasoning so coding agents can understand how your code fits together.

Where are my code and knowledge graph stored?

Your repository and its indexed knowledge graph stay on your device. Indexing, graph queries and reasoning write-back run through the local Sovereign runtime.

Does any code or graph data leave my machine?

Sovereign does not send your source code, graph records, query text or graph responses to the Novaya hosted graph backend. Account authorization and usage accounting send account and installation identifiers, plan information and numeric usage to Novaya. If you pair the dashboard, your browser reads graph data directly from your local runtime.

Can I use Novgraph Sovereign with a hosted coding agent?

It depends on where the agent runs. An agent running on your device can use Sovereign while relying on a cloud AI model. An agent running entirely in a hosted environment needs a supported way to access the Sovereign runtime in its execution environment; installing Sovereign on your computer alone does not give it access.

How does Sovereign differ from Hosted?

Sovereign indexes your local checkout and executes graph queries on your device. Hosted indexes connected repositories and executes queries through the Novaya hosted graph service. Both use the same Novgraph commands and MCP tools. Sovereign never silently falls back to Hosted.

Which editors and AI agents can use it?

Editors and coding agents can access Sovereign through its MCP tools or the novgraph command-line interface. Your agent needs support for one of these integrations and access to the device running the Sovereign runtime.

How do I install it and keep the graph updated?

Install the client with uv tool install novaya, then run novgraph install sovereign inside your repository. Refresh the local index as your code changes. The graph reflects its latest indexed state; newer and uncommitted changes should also be checked directly in the working tree.

Do I need to pair with the dashboard?

No. Coding agents can use the CLI and MCP tools without browser pairing. Run novgraph pair when you want the Novaya dashboard to access your local graph.

How do account authorization and usage limits work?

Sovereign requires a Novaya account. Hosted and Sovereign graph calls share your plan allowance: 1,000 on Free, 25,000 on Plus and 100,000 on Pro every 30 days. Graph execution stays local while account authorization and numeric usage accounting are handled separately. Run novgraph doctor to diagnose access problems.