# Isonomia

> Isonomia is open-source software for storing, citing, and checking the reasoning behind a conclusion. It turns an argument into structured, verifiable data instead of prose: a claim or argument becomes its own addressable object carrying its support, the sources behind it (fetched, timestamped, and verifiable, so the record holds even if the original link rots), the strongest objection on file against it, and whether it has survived challenge — something a person or an AI system can cite precisely and check.

Isonomia is not primarily a social media platform, a polling app, or a generic forum. It is epistemic infrastructure: the place the reasoning behind a decision is kept, so a search engine, a researcher, and an automated agent can all read, cite, and contest the same object instead of re-judging a document every time.

Core principles:
- Reasoning stored as structured, addressable, verifiable data — not disposable prose
- Durable public argument and claim permalinks with end-to-end provenance
- Every citation carries its strongest known counter-argument by default
- AI authorship flagged honestly; standing earned only through human ratification
- Chronological, non-algorithmic social spaces
- No behavioral tracking, ads, or engagement ranking
- Free and self-hostable

## Essential

- [About Isonomia](https://isonomia.app/about): Plain-language overview of what Isonomia is and who it is for.
- [Documentation](https://isonomia.app/docs): Index of public documentation.
- [Architecture](https://isonomia.app/docs/architecture): Social layer, reasoning layer, argument graph, evidence system, and institutional workflow.
- [Argument graph](https://isonomia.app/docs/argument-graph): How claims, arguments, critical questions, challenges, citations, and confidence work.
- [Public search](https://isonomia.app/search/arguments): Search interface for public arguments and claims.
- [Public claim permalinks](https://isonomia.app/c/): Canonical public claim URLs (`/c/{moid}`).
- [Public argument permalinks](https://isonomia.app/a/): Canonical public argument URLs (`/a/{shortCode}`).

## Source code

- [GitHub repository](https://github.com/Iso-nomia/Isonomia): Open-source implementation (MIT). Architecture, issue tracker, and security disclosure policy.

## Machine-readable

- [Sitemap](https://isonomia.app/sitemap.xml): Indexable public URLs.
- [Robots](https://isonomia.app/robots.txt): Crawler access rules.
- [Full context for LLMs](https://isonomia.app/llms-full.txt): Longer companion file with fuller project context.
- [Argument graph manifest](https://isonomia.app/.well-known/argument-graph): Machine-readable description of public argument-graph endpoints.
- [LLM discovery doc](https://isonomia.app/.well-known/llms.txt): Retrieval shapes, citation contract, and MCP surface.
- [OpenAPI 3.1 spec](https://isonomia.app/api/v3/openapi.json): Machine-readable API description.
- [API search](https://isonomia.app/api/v3/search/arguments): JSON search endpoint for public arguments.

## Optional

- [Chrome extension](https://isonomia.app/docs/chrome-extension): Browser extension for creating evidence-backed arguments from webpages.
- [Self-hosting](https://isonomia.app/docs/self-hosting): How to deploy and operate Isonomia.
- [Privacy](https://isonomia.app/docs/privacy): Data ownership, tracking, and retention.