Metadata-Version: 2.4
Name: sovereign-protocol
Version: 0.1.7
Summary: Application-neutral runtime for the Sovereign Protocol
License-Expression: LGPL-3.0-or-later
Project-URL: Homepage, https://github.com/sovereign-protocol/core
Project-URL: Source, https://github.com/sovereign-protocol/core
Project-URL: Issues, https://github.com/sovereign-protocol/core/issues
Project-URL: Changelog, https://github.com/sovereign-protocol/core/blob/main/CHANGELOG.md
Project-URL: Specification, https://github.com/sovereign-protocol/core/blob/main/SPECIFICATION_S_PROTOCOL.md
Keywords: local-first,collaboration,crdt-alternative,protocol,peer-to-peer
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.14
Classifier: Operating System :: Microsoft :: Windows
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Communications
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: LICENSES/CC-BY-4.0.txt
License-File: LICENSES/GPL-3.0.txt
Requires-Dist: paramiko<6,>=3.4
Requires-Dist: starlette<2,>=0.37
Requires-Dist: uvicorn<1,>=0.30
Provides-Extra: test
Requires-Dist: pytest<10,>=8; extra == "test"
Requires-Dist: setuptools>=68; extra == "test"
Dynamic: license-file

# Sovereign Core

Sovereign Core is the application-neutral reference implementation of the
Sovereign Protocol (S-Protocol): local-first collaboration in which every
participant owns an explicit perspective and decides how differences converge.

It provides the protocol tree, Session transition and reaction mechanics,
application hosting, Local/SFTP mailbox channels, and content-addressed
blob storage. It contains no product-application policy.

## Quickstart

Requires Python 3.10 or newer. Windows 10/11 is supported; Linux and macOS are
currently experimental.

```powershell
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e ".[test]"
.\.venv\Scripts\python.exe -m pytest -q
.\.venv\Scripts\sovereign-host.exe 9305:manual
```

The public Python surface is documented in `PUBLIC_API.md`. Protocol behavior
and wire formats are defined in `SPECIFICATION_S_PROTOCOL.md`.

## License

Software is `LGPL-3.0-or-later`. Documentation and the normative specification
are `CC-BY-4.0`. See `LICENSE`, `LICENSES/`, and `NOTICE`.
