See what your AI agent actually did. One line. Zero config.
Project description
mokra
See what your AI agent actually did. One line. Zero config.
Installation
pip install mokra
Quick Start
from mokra import observe
with observe() as world:
# Run your AI agent here
agent.run("Send a welcome email to new users")
# See exactly what happened
print(world)
Features
- Zero config: Works out of the box with any HTTP-based service
- Deep adapters: Rich insights for Stripe, Slack, SendGrid, and more
- Framework support: First-class support for LangChain and CrewAI
- Test generation: Automatically generate pytest tests from observed behavior
Supported Services
| Service | Adapter Type | Features |
|---|---|---|
| Stripe | Deep | Payment intents, customers, subscriptions |
| Slack | Deep | Messages, channels, reactions |
| SendGrid | Deep | Emails, templates, recipients |
| Any HTTP | Generic | Request/response logging |
Documentation
Releases & Versioning
mokra follows Semantic Versioning with automatic version detection from git tags:
MAJOR.MINOR.PATCH
v0.1.0 → First release
v0.1.1 → Bug fix
v0.2.0 → New feature
v1.0.0 → Major/breaking change
Pre-release versions:
v0.1.0a1- Alpha releasesv0.1.0b1- Beta releasesv0.1.0rc1- Release candidates
Publishing a new version:
git tag v0.2.0
git push origin v0.2.0
That's it! The version is read automatically from the git tag - no need to edit pyproject.toml.
Note: PyPI requires unique version numbers - you cannot overwrite an existing version.
Contributing
See CONTRIBUTING.md for guidelines.
License
MIT License - see LICENSE for details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mokra-0.1.0.tar.gz.
File metadata
- Download URL: mokra-0.1.0.tar.gz
- Upload date:
- Size: 17.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e8836240919aff752975e3979dd76626a73137ff7010ab2c3756a136c5f39d38
|
|
| MD5 |
a114f8c7dbd9a585f3d0eb6cc902681a
|
|
| BLAKE2b-256 |
340809ac105f843a496eb37eabb2c3bea478bae8481cb35d9a7a31d76877000e
|
Provenance
The following attestation bundles were made for mokra-0.1.0.tar.gz:
Publisher:
ci.yml on handled-engineering/mokra-python
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mokra-0.1.0.tar.gz -
Subject digest:
e8836240919aff752975e3979dd76626a73137ff7010ab2c3756a136c5f39d38 - Sigstore transparency entry: 1059338268
- Sigstore integration time:
-
Permalink:
handled-engineering/mokra-python@67ab2abee1b7eb9dbbf1c71903ec7392d40c537f -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/handled-engineering
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@67ab2abee1b7eb9dbbf1c71903ec7392d40c537f -
Trigger Event:
push
-
Statement type:
File details
Details for the file mokra-0.1.0-py3-none-any.whl.
File metadata
- Download URL: mokra-0.1.0-py3-none-any.whl
- Upload date:
- Size: 13.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5562e41314f8fbeacb35c140004db9904df1a03ca8ec65ebb4668d0483645782
|
|
| MD5 |
6f5f8d3f4a2f68c4d8baa00a48f2558c
|
|
| BLAKE2b-256 |
b4cb8894e0fa0e37fe510eb753a3b985d4ff12b5df77c0dd371e3ecdc2d675a2
|
Provenance
The following attestation bundles were made for mokra-0.1.0-py3-none-any.whl:
Publisher:
ci.yml on handled-engineering/mokra-python
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mokra-0.1.0-py3-none-any.whl -
Subject digest:
5562e41314f8fbeacb35c140004db9904df1a03ca8ec65ebb4668d0483645782 - Sigstore transparency entry: 1059338305
- Sigstore integration time:
-
Permalink:
handled-engineering/mokra-python@67ab2abee1b7eb9dbbf1c71903ec7392d40c537f -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/handled-engineering
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@67ab2abee1b7eb9dbbf1c71903ec7392d40c537f -
Trigger Event:
push
-
Statement type: