Metadata-Version: 2.4
Name: helium-solo
Version: 0.1.0
Summary: Helium by Kasanki Labs: record, replay, test and fix safe AI agents.
Author: Kasanki Labs
License-Expression: LicenseRef-Helium-Solo
License-File: TERMS.txt
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Testing
Requires-Dist: kasanki-helium-sdk==0.1.0
Requires-Dist: mcp>=1.24 ; extra == 'mcp'
Requires-Dist: fastembed>=0.7 ; extra == 'search'
Requires-Dist: numpy>=1.26 ; extra == 'search'
Requires-Python: >=3.10
Project-URL: Homepage, https://helium-solo.pages.dev
Provides-Extra: mcp
Provides-Extra: search
Description-Content-Type: text/markdown

# Helium Solo

Record, replay, test and fix safe AI agents, on your own machine. Free, by Kasanki Labs.

```
pip install helium-solo
```

This installs the `helium` command and the Kasanki Helium SDK (`import kasanki_helium as helium`).

## Record an agent

With no code changes:

```
helium run agent.py
```

Or one run per task, with two lines:

```python
import kasanki_helium as helium


@helium.agent()
def handle_ticket(ticket): ...
```

OpenAI, Anthropic and LangChain calls are recorded, with secrets removed before anything is saved. The engine must be running: open the Helium Solo app, or run `helium init` once and then `helium monitor run`.

When `helium` starts your agent, it adds the names in the project's `.env` that aren't already set (the nearest `.env` up to the repository's root), and never prints them, so keep keys there.

## Then

- `helium replay <run_id>` runs the agent again exactly, offline and free.
- `helium fork <run_id> --at <step>` changes something at a step and carries on live.
- `helium test <set>` runs a test set with your graders and compares it with the last result.
- `helium fix <set>` looks for a fix that passes the tests and hands it over as a diff.
- `helium verify` checks that no recording was changed.

The Helium Solo desktop app shows runs, replays, tests and fixes as they happen: https://helium-solo.pages.dev

Helium Solo runs on your machine and sends nothing to Kasanki Labs. Its terms are in `TERMS.txt`. The SDK is open source under the GNU AGPL v3.
