Metadata-Version: 2.4
Name: sovereign-protocol
Version: 0.1.1
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: requests<3,>=2.31
Requires-Dist: starlette<2,>=0.37
Requires-Dist: uvicorn<1,>=0.30
Provides-Extra: test
Requires-Dist: pytest<10,>=8; 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, direct HTTP channels, 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`.
