Skip to main content

s0ma-lang

s0ma-lang installs all of s0ma, the software self-knowledge platform, under one name. It carries no code of its own. It depends on the four distributions s0ma is made of, each at exactly its own version, so one name and one version give you a toolchain whose parts were released together.

What it installs

Distribution Module What it is
s0ma-lang-core s0ma The runtime: the registry every part is declared into, the verifiers, the lifecycle, and the surfaces that answer what exists and why.
s0ma-lang-dsl s0ma_dsl The .s0ma language, its compiler, and the s0ma command line.
s0ma-lang-mcp s0ma_mcp The authoring server a coding agent works through, over the Model Context Protocol.
s0ma-lang-studi0 s0ma_studi0 studi0, the local visual environment (s0ma studi0), whose sh0w renderer draws a project's component graph from its build artifacts.

The s0ma and s0ma-mcp commands arrive with it, because the distributions that provide them are among its dependencies. There is nothing to import from s0ma-lang itself: the modules are the four in the table.

Install

s0ma is on PyPI:

pip install s0ma-lang

That one command installs all four. In a uv project, uv add s0ma-lang does the same. The other ways in, taking one part, working inside a checkout or building the wheels yourself, are in the root README's "Install" section, and getting started is the journey to walk once the s0ma command runs.

One version, exactly

The five distributions are released together at one version. s0ma-lang at a given version requires each of the four at exactly that version, not at that version or later. Installing a pinned s0ma-lang therefore cannot resolve to a mixed set, and upgrading s0ma-lang moves all four together.

When to take a part instead

Each of the four installs on its own, and dependencies between them point one way: s0ma-lang-mcp and s0ma-lang-studi0 depend on s0ma-lang-dsl, which depends on s0ma-lang-core.

  • An application that runs s0ma components and does not build them needs s0ma-lang-core alone. It has zero hard runtime dependencies.
  • A project that compiles .s0ma sources in its own build needs s0ma-lang-dsl, which brings the runtime with it.
  • Take s0ma-lang when you are writing s0ma and want the language, the authoring server and the viewer together.

Why the names carry lang

The Python package index compares names with a zero read as the letter o, and unrelated projects already hold the letter-o spellings of the shorter names. Only the distribution names carry lang. The modules you import, the s0ma and s0ma-mcp commands, and the .s0ma file extension keep the short spelling, with a digit zero.

Documentation

Once the toolchain is installed, s0ma docs opens the same map in a terminal.

License

Apache License 2.0. See LICENSE for the text. The four distributions this one depends on are Apache-2.0 too, each with its own LICENSE.

Metadata

Release files for s0ma-lang 0.22.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for s0ma-lang 0.22.0
File Size Uploaded Provenance Actions
s0ma_lang-0.22.0.tar.gz 7.7 kB Without provenance Details for s0ma_lang-0.22.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for s0ma-lang 0.22.0
File Interpreter ABI Platform Actions
s0ma_lang-0.22.0-py3-none-any.whl Python 3 none any Details for s0ma_lang-0.22.0-py3-none-any.whl

Total release size: 14.6 kB

Release files / s0ma_lang-0.22.0.tar.gz

Download URL s0ma_lang-0.22.0.tar.gz
Size 7.7 kB
Tags Source
SHA-256 checksum
How to use checksums
0b86eba8c9feda3f2b846e1f96458e1f0b376360a82ad88e423f7f3c00e00996
BLAKE2b-256 checksum
How to use checksums
ecfea4f2479e4ef8e0e12def844c0e2e43cd87336860612d51e045058a2ff5be
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.9.21 {"installer":{"name":"uv","version":"0.9.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / s0ma_lang-0.22.0-py3-none-any.whl

Download URL s0ma_lang-0.22.0-py3-none-any.whl
Size 6.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2a03d3716620349c273f0b29212f324b84baa2575054c57116495ee339afa506
BLAKE2b-256 checksum
How to use checksums
75ffc25a7d71824b45afdc2fc11b7035ffb106677d844b57b5bcf87cfc526a24
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.9.21 {"installer":{"name":"uv","version":"0.9.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for s0ma-lang 0.22.0

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A 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.

Release history Release notifications | RSS feed

This release

0.22.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page