# Nanitics

> An open-source Python SDK for engineers building single-agent and multi-agent systems in production. Compose ReAct, Reflexion, and coordination patterns, with a built-in trace viewer.

Nanitics is shaped as composable primitives, not as a framework. Every agent loop, tool call, evaluation, and coordination event emits a structured event the built-in Observatory trace viewer renders as a hierarchical timeline. The SDK ships under Apache License 2.0 and is pre-1.0; the public surface is `nanitics.__all__` and breaking changes are documented in `CHANGELOG.md`.

## Canonical pages

- [Homepage](https://nanitics.dev/): the dual claim, a runnable composing example, the nine groups of primitives, FAQ, and install instructions.
- [Philosophy](https://nanitics.dev/philosophy): the long-form design thesis. Composable primitives, trace-first observability, real-services validation, the maturity model, and the documentation discipline.

## Documentation

- [API reference](https://docs.nanitics.dev/): the full auto-generated reference, anchored to docstrings.
- [Guides](https://github.com/nanitics/nanitics/tree/main/docs/guides): decision guidance for each primitive group. When to reach for it, what it costs, what it buys.
- [Getting started](https://github.com/nanitics/nanitics/blob/main/docs/guides/getting-started.md): the shortest path from install to first running agent.

## Source and runnable code

- [Source on GitHub](https://github.com/nanitics/nanitics): the SDK repository.
- [Examples](https://github.com/nanitics/nanitics/tree/main/examples): runnable example programs. Every example runs deterministically with `MockLLMClient` and without API keys.
- [Homepage example](https://github.com/nanitics/nanitics/blob/main/examples/homepage.py): the three-layer composing agent shown on the homepage.

## Distribution

- [PyPI](https://pypi.org/project/nanitics/): `pip install nanitics`.

## Discussion and bug reports

- [GitHub Discussions](https://github.com/nanitics/nanitics/discussions): design questions, proposals, integration questions.
- [GitHub Issues](https://github.com/nanitics/nanitics/issues): bug reports and behavioural surprises.

## Project documents

- [License](https://github.com/nanitics/nanitics/blob/main/LICENSE): Apache 2.0.
- [Contributing](https://github.com/nanitics/nanitics/blob/main/CONTRIBUTING.md): the contribution workflow.
- [Code of Conduct](https://github.com/nanitics/nanitics/blob/main/CODE_OF_CONDUCT.md).
- [Governance](https://github.com/nanitics/nanitics/blob/main/GOVERNANCE.md).
- [Changelog](https://github.com/nanitics/nanitics/blob/main/CHANGELOG.md): release notes and breaking-change records.