This release is a pre-release and may not be stable for production use.
Songe
A local model that learns from how you use it.
Use your model as usual through opencode, pi or any OpenAI-compatible tool. When your agent is quiet, Songe looks at what happened after each of the model's actions — the tool result, the error, your next message — and teaches the model to see it coming. A new version is used only if it passes checks. Nothing leaves your machine.
Install
macOS with Homebrew:
brew install sous-labs/tap/songe
songe init
Or with pip (Python 3.11 or later; with Homebrew's Python use pipx install songe):
pip install songe
songe init
songe init finds your model server and your agents, shows what it will change, and asks once. Then pick a songe/… model in your agent. In opencode, a local default model switches over automatically.
Needs a model served locally by LM Studio, Ollama, llama.cpp, mlx-lm or vLLM. Learning runs on Apple Silicon (MLX); Linux and Windows with NVIDIA or AMD are supported but less tested. Machines without a GPU still serve and record.
Use
There is nothing to do. To look:
songe # what it is doing
songe open # dashboard in your browser
songe models # each model and its learning level
To change things:
songe models MODEL off|new|all # learning level for one model
songe undo MODEL # go back one version
songe pause
songe resume
songe sleep # learn now instead of waiting
songe doctor # check the setup
songe forget # delete recorded conversations (learned versions stay)
Learning levels: off only records; new (default) learns from conversations from now on; all also learns from earlier ones.
In the dashboard each model has a Dream button: it reads your new replies now, however few, and trains too if there are enough conversations, memory and power. It says what it started and what is still missing.
How it learns
- The model as it was, shown the conversation and what happened next, is the teacher.
- The same model with a small adapter, shown only the conversation, is the student. It answers in its own words and the teacher scores each token (on-policy distillation).
- Each round trains on new conversations once, mixed with earlier ones so old skills stay.
- The update is used only if it does better on conversations it never trained on and no worse on general tasks. Otherwise nothing changes.
Songe never runs your tools. It only reads what already happened.
When it runs
Only when your agent is quiet, there is enough free memory, the battery is not low, the machine is cool, and there are new conversations to learn from. Memory needs are measured once on your machine. When you come back it stops at once, saves its place and continues later.
What it changes
- Its data folder:
~/Library/Application Support/songeon macOS,$XDG_DATA_HOME/songeon Linux,%LOCALAPPDATA%\songeon Windows. - A
songe/folder in LM Studio's models folder with the current learned version. Older versions are rebuilt when you return to them. Your own models are never touched. - One provider entry in opencode and pi, with a backup.
- A background service that starts at login.
No account, no notifications.
Upgrade and remove
brew upgrade songe or pip install -U songe: the service moves to the new version by itself in a quiet moment.
songe uninstall stops the service and restores your agent settings; add --purge to also delete its data and learned versions. Run it before brew uninstall songe.
Details and development: docs/DEVELOPMENT.md. Design: DESIGN.md.
Metadata
Release files for songe 0.1.0a12
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| songe-0.1.0a12.tar.gz | 662.8 kB | With provenance | Details for songe-0.1.0a12.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| songe-0.1.0a12-py3-none-any.whl | Python 3 | none | any | Details for songe-0.1.0a12-py3-none-any.whl |
Total release size: 1.0 MB
Release files / songe-0.1.0a12.tar.gz
| Download URL | songe-0.1.0a12.tar.gz |
|---|---|
| Size | 662.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
be571cb0b92b80d65d7c15c5cf129cfe82fdac29aa1614edf8d664bb535d64de
|
|
BLAKE2b-256 checksum How to use checksums |
aa1a6f9fd1b43cea7d5c3c940a3992040cb685f60395506f01334db7ee8708f9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.
Transparency logRelease files / songe-0.1.0a12-py3-none-any.whl
| Download URL | songe-0.1.0a12-py3-none-any.whl |
|---|---|
| Size | 363.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
642b5a807fd9a1dbdcd5e4807da3147e27727b5b80268d6cd20c089c76b63c93
|
|
BLAKE2b-256 checksum How to use checksums |
3064710902dc7a96ad1857a8256cdc48e2edfaaee2f1a7763f9ec20b2d2b7195
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.
Transparency logSecurity for songe 0.1.0a12
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for songe-0.1.0a12.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.