lackpy

Python that lacks most of Python. A micro-inferencer that translates natural language intent into sandboxed tool-composition programs.

What it does

$ lackpy -c "read file main.py and count its lines" --profile read_file,find_files

lackpy takes an intent, generates a restricted Python program using a local model you configure (any Ollama-served coder model), validates it against a strict AST whitelist, and runs it with traced tool calls. One MCP call replaces N tool round-trips.

Install

pip install lackpy            # runtime + local/cloud model inference (via woollama)
pip install lackpy[full]      # + all optional features (sandbox, mcp, blq, …)

pip install lackpy-lang       # JUST the language (grammar/validator/grader/spec),
                              # no runtime — for tools that only reason about programs

Model inference is built in — calls route through woollama's core (a dependency), so local Ollama and cloud backends (Anthropic, OpenAI, …) all work without a per-vendor extra; cloud backends just need the relevant API key in your environment.

lackpy and lackpy-lang share the lackpy namespace (PEP 420); neither ships a top-level lackpy/__init__.py, so import from submodules (from lackpy.lang import validate, from lackpy.service import LackpyService).

Development (monorepo)

This repo builds two distributions. For a working editable checkout, install both — lackpy pins lackpy-lang, which isn't on PyPI until its own tag, so install the local copy first:

pip install -e ./packages/lackpy-lang -e ".[dev]"

Quick start

lackpyctl init --ollama-url http://localhost:11434   # writes .lackpy/config.toml
lackpy -c "find all python files" --profile read_file,find_files

lackpyctl init wires a local Ollama model into the inference order — pick the model with --ollama-model (the choice is per-machine, not a package default). Without it, only the deterministic templates/rules tiers run and compositional intents won't generate.

from lackpy.service import LackpyService
from lackpy.kit.toolbox import ToolSpec, ArgSpec
import asyncio

async def main():
    svc = LackpyService()
    result = await svc.delegate("read file README.md", profile=["read_file"])
    print(result["output"])

asyncio.run(main())

Documentation

Full docs at lackpy.readthedocs.io:

Part of the Rigged Suite

lackpy is part of the Rigged developer tool suite but is independently installable.

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lackpy-0.15.1.tar.gz (838.6 kB view details)

Uploaded Aug 14, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

lackpy-0.15.1-py3-none-any.whl (260.1 kB view details)

Uploaded Aug 14, 2026 Python 3

File details

Details for the file lackpy-0.15.1.tar.gz.

File metadata

Download URL: lackpy-0.15.1.tar.gz
Upload date: Aug 14, 2026
Size: 838.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for lackpy-0.15.1.tar.gz
Algorithm	Hash digest
SHA256	`d6f7faf353a60212f3147e992bc4dbb8683e4dbfea412b36fdfeac6df3083cf3`
MD5	`ae7c953817bfbd2d8a21529ed54b62d3`
BLAKE2b-256	`bd0563489173d049a26371d7b832287de50627558501514fa83d0973ada6149e`

See more details on using hashes here.

Provenance

The following attestation bundles were made for lackpy-0.15.1.tar.gz:

Publisher: ci.yml on teaguesterling/lackpy

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: lackpy-0.15.1.tar.gz
- Subject digest: d6f7faf353a60212f3147e992bc4dbb8683e4dbfea412b36fdfeac6df3083cf3
- Sigstore transparency entry: 2459632954
- Sigstore integration time: Aug 14, 2026
Source repository:
- Permalink: teaguesterling/lackpy@5a8f86f95ca7d76321ea5ae88b54bdc4d36ee008
- Branch / Tag: refs/tags/v0.15.1
- Owner: https://github.com/teaguesterling
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: ci.yml@5a8f86f95ca7d76321ea5ae88b54bdc4d36ee008
- Trigger Event: push