Ossature

An open-source build system that turns written specs and architecture into working code — an LLM generates code under tight constraints, task by task with narrow context windows, instead of attempting an entire codebase at once.

197stars
6forks
MIT License
Python

Ossature treats software specifications as the actual source of truth rather than throwaway prompts: you write a spec describing what the software should do, optionally lay out its architecture, and Ossature validates the spec, audits it for gaps, builds a step-by-step plan, and generates code task by task with an LLM operating under tight, narrow context constraints for each step.

This task-by-task approach with narrow context is the core design bet against typical “generate the whole app in one shot” AI coding tools, which tend to lose coherence on larger projects. By breaking work into discrete, spec-validated tasks, Ossature aims for more reliable, auditable code generation on projects too large for a single prompt to handle well.

MIT licensed and distributed via PyPI, the project is explicitly labeled 0.x and unstable — APIs, spec formats, CLI flags, and internal behavior may change significantly between releases without prior deprecation, so pinning versions and checking the changelog before upgrading is recommended.

What You Get

  • A spec validation and gap-auditing step before any code generation begins
  • Automatic build-plan generation breaking a project into discrete, sequential tasks
  • Task-by-task code generation with narrow context windows per task instead of whole-codebase generation
  • CLI-driven workflow distributed via PyPI, with published documentation and a Discord community

Common Use Cases

  • Building larger software projects with LLM-generated code where whole-codebase generation tends to lose coherence
  • Treating a written specification as the durable source of truth for a project rather than disposable chat prompts
  • Auditing a specification for gaps and inconsistencies before committing to a build plan
  • Generating code in reviewable, narrow-context increments rather than one large, hard-to-verify output

Under The Hood

Architecture Ossature’s pipeline runs spec validation and gap-auditing first, then produces a task-ordered build plan, then generates code for each task under a deliberately narrow context window rather than exposing the LLM to the entire codebase state at once. This narrow-context-per-task design is the project’s central architectural bet: it trades the convenience of one-shot generation for more reliable, incrementally verifiable output on larger projects.

Tech Stack Python, using Pydantic for spec/data validation, distributed via PyPI (pip install ossature) with CI and Codecov coverage tracking, and published documentation at docs.ossature.dev.

Code Quality The project runs CI and tracks coverage via Codecov, and is explicit and upfront about its own instability (0.x, breaking changes without deprecation) rather than overselling maturity — a notably honest stance for an early-stage tool; GitHub activity shows very active development but somewhat inconsistent maintenance cadence typical of a project still finding its stable API shape.

What Makes It Unique Most AI coding tools optimize for generating as much as possible from a single prompt; Ossature explicitly rejects that approach in favor of spec validation, gap auditing, and narrow-context task-by-task generation — a build-system mental model applied to LLM code generation rather than a chat-to-code mental model.

Self-Hosting

Licensing Model MIT licensed — fully open source with no license key.

Self-Hosting Restrictions Not applicable; it’s a local CLI/build tool requiring your own LLM API credentials.

License Key Required No.

Join founders buildingwith open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on Substack

No spam. Unsubscribe anytime.

Join 750+ subscribers
No spam. Unsubscribe anytime.

Search