Metadata-Version: 2.3
Name: ossature
Version: 0.0.1
Summary: Specification and architecture driven code generation toolkit.
Author: Beshr Kayali Reinholdsson
Author-email: Beshr Kayali Reinholdsson <me@beshr.com>
License: MIT
Requires-Dist: click>=8.3.1
Requires-Dist: content-types>=0.3.0
Requires-Dist: pydantic>=2.12.5
Requires-Dist: pydantic-ai>=1.62.0
Requires-Dist: questionary>=2.1.1
Requires-Dist: rich>=14.3.2
Requires-Dist: tomli>=2.4.0
Requires-Dist: tomli-w>=1.2.0
Requires-Python: >=3.14
Project-URL: Homepage, https://docs.ossature.dev
Project-URL: Repository, https://github.com/ossature/ossature
Project-URL: Documentation, https://docs.ossature.dev
Project-URL: Changelog, https://github.com/ossature/ossature/blob/master/CHANGELOG.md
Description-Content-Type: text/markdown

# Ossature

[![CI](https://github.com/ossature/ossature/actions/workflows/ci.yml/badge.svg)](https://github.com/ossature/ossature/actions/workflows/ci.yml)

An open-source harness for spec-driven code generation.

You write a specification, optionally lay out the architecture, and Ossature breaks it down into a build plan that gets executed step by step with an LLM doing the code generation under tight constraints. The specs are your source of truth, you review the plan before anything gets built, and when something breaks you fix that step and keep going instead of starting over.

Works with Anthropic, OpenAI, Mistral, Google, and most other hosted providers, as well as local models through Ollama.

*Ossature* (pronounced **OSS-uh-cher**) means the underlying framework or skeleton of a structure.

## Quick start

Requires Python 3.14+.

```bash
pip install ossature
```

Or run it directly with [uvx](https://docs.astral.sh/uv/):

```bash
uvx ossature --version
```

Set your LLM provider API key:

```bash
export ANTHROPIC_API_KEY="sk-ant-..."
# or OPENAI_API_KEY, MISTRAL_API_KEY, etc.
```

Create and build a project:

```bash
ossature init myproject && cd myproject
ossature new my-feature
# edit specs/my-feature.smd
ossature validate
ossature audit
ossature build
```

## Examples

See [ossature-examples](https://github.com/ossature/ossature-examples) for complete projects with specs, build plans, and generated code.

## Documentation

Full docs at [docs.ossature.dev](https://docs.ossature.dev). The [workflow guide](https://docs.ossature.dev/getting-started/workflow.html) walks through a complete project from init to generated code.

## License

MIT
