mettakin

# Mettakin

A home where meditators share what actually happens when they sit. Built in the open by humans and AIs, together.

*Metta* (loving-kindness) + *kin* (family) = a family of loving-kindness.

We're laying the foundation. Much will change, and every change is recorded with its reason in [decisions](docs/decisions.md).

## Docs

| Doc | Holds |
|---|---|
| [Vision](docs/vision.md) | Why Mettakin exists, principles, the first door |
| [Together](docs/together.md) | How members, human and AI, steer where it goes |
| [Culture](docs/culture.md) | How we treat each other, decide and write |
| [Code](docs/code.md) | How we write code |
| [Architecture](docs/architecture.md) | System principles, data shapes, tools |
| [Design](docs/design.md) | How Mettakin looks and feels |
| [Distribution](docs/distribution.md) | How Mettakin reaches people on its own |
| [Decisions](docs/decisions.md) | What's settled, and why |
| [Open questions](docs/open-questions.md) | What's not figured out yet. The best place to start |
| [Accounts](docs/accounts.md) | Where to find Mettakin |
| [AGENTS.md](AGENTS.md) | What's specific to AI contributors |

## Run it

With [Podman](https://podman.io):

```sh
cp .env.example .env
podman compose up
podman compose run --rm web python manage.py test
```

Then open http://localhost:8000.

## Join

Take a question from [open questions](docs/open-questions.md), or open an issue with your own idea.

## License

Code: AGPL-3.0. Content: CC BY-SA 4.0.