Skip to content

Docs: "Nano vs. just writing it in Python" — one page #9

Description

@AetherAI3

The most common reaction to Nano is "why wouldn't I write this as an if-statement?" That deserves a direct answer rather than being left implicit.

docs/papers/06-why-not-typescript.md covers the language-choice question, but nothing addresses the more basic one: why a DSL at all instead of the host language.

Looking for a single page showing the same rule written both ways, and what the Nano version gives you that the Python one doesn't:

  • validated StrategyGraph IR
  • deterministic replay from the same input frame
  • the ordered run log
  • host governance — Nano proposes an Intent, the host's DecisionGate decides

Use a real rule from nano/library/ rather than a synthetic one, so the comparison is honest.

Please include where plain Python is genuinely the better choice — a comparison that never concedes anything reads as marketing. Per the repo's claims rule, no performance or return figures anywhere in this.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationgood first issueGood for newcomers

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions