# Suzent

> Suzent is a sovereign AI agent: an open-source, local-first agent whose identity, memory, skills, workspace, and runtime remain under the user's control. Models are replaceable; the agent is not.

A sovereign AI agent is an AI agent whose identity, memory, skills, workspace, and runtime are owned and governed by its user rather than by a model provider or platform. Its durable state lives in files the user can read, edit, version, and move; its actions run inside permission boundaries the user defines; and replacing the underlying model does not reset the agent. Suzent is an implementation of that definition.

Full text of this documentation, in one file: https://suzent.com/llms-full.txt

## Start here

- [What is a sovereign AI agent?](https://suzent.com/sovereign): The definition, the four conditions of agent sovereignty, and a five-question ownership test.
- [Introduction](https://suzent.com/docs/getting-started/intro): What Suzent is and how it differs from a rented AI account.
- [Quickstart](https://suzent.com/docs/getting-started/quickstart): Install and run Suzent.

## Sovereignty architecture

- [Models & Providers](https://suzent.com/docs/models): Sovereign mind — any model provider, with identity kept outside the model.
- [Memory](https://suzent.com/docs/features/memory): Sovereign continuity — readable, file-backed memory where the index serves the files.
- [Permissions & approvals](https://suzent.com/docs/features/tools/human-in-the-loop): Sovereign authority — approval boundaries for tool execution.
- [Workspace & sandbox](https://suzent.com/docs/features/filesystem): Sovereign vessel — controlled workspaces, filesystem access, and sandboxed execution.
- [GitHub sync](https://suzent.com/docs/features/github-sync): Sovereign continuity — portable agent state with credentials kept local.
- [Automation](https://suzent.com/docs/features/automation): Goals, schedules, and continuing work.
- [Devices & other agents](https://suzent.com/docs/features/nodes): Extending the agent across approved devices, A2A agents, and editors.

## Source

- [GitHub repository](https://github.com/cyzus/suzent): Apache-2.0 licensed source, releases, issues, and contribution history.
- [PyPI package](https://pypi.org/project/suzent/): Published Python distribution.