# DevKit

This archive bundles the Digital Substrate code-generation toolchain — the
Kibo code generator, the `kibo-template-viper` template pack (Python and
C++ surfaces), CLI/GUI tools (`dsm_util`, `dbe`, `cdbe`, `commit_admin`),
and DSM reference samples. The `dsviper` runtime installs separately
from PyPI (see `requirements.txt`).

Top-level layout: `tools/`, `templates/`, `dsm-samples/`, `LICENSES/`.
Component versions and documentation URLs are in `MANIFEST.txt`.
Licensing notice in `LICENSE`.

Full documentation: <https://docs.digitalsubstrate.io/>.

## Supported platforms

- macOS 14+ (x86_64 / arm64)
- Windows 10 / 11 (x86_64 / arm64)
- Linux Ubuntu 24.04 LTS (x86_64 / arm64)

Python 3.10–3.14 on all platforms. On Windows, install the
[Microsoft Visual C++ Redistributable](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170)
([x64](https://aka.ms/vs/17/release/vc_redist.x64.exe),
[arm64](https://aka.ms/vs/17/release/vc_redist.arm64.exe))
if a DLL is missing.

## Install

Since Python 3.12 the system installation is often protected
([PEP 668](https://peps.python.org/pep-0668/)), so install into a venv:

```bash
python3 -m venv ~/venv
source ~/venv/bin/activate            # macOS / Linux
# or: ~/venv/Scripts/activate         # Windows

pip install -r requirements.txt
python3 -c "import dsviper; print(dsviper.version())"
```

## IDE plugins

- **VS Code** — [Marketplace](https://marketplace.visualstudio.com/items?itemName=DigitalSubstrate.ds-dsm) · [source](https://github.com/digital-substrate/dsm-vscode)
- **JetBrains** — [Marketplace](https://plugins.jetbrains.com/plugin/31186-dsm-language-support) · [source](https://github.com/digital-substrate/dsm-jetbrains)
