# All Concepts of Life

> A library of the world's contemplative-wisdom traditions, each made
> practical through interactive tools, source quotes, and a hand-curated
> connection graph showing how traditions relate.

humanconcepts.in is a curated index of 24+ wisdom traditions — Stoicism,
the Bhagavad Gita, Sufism, Hygge, Ikigai, Wabi-Sabi, Tao, Ubuntu, Maat,
Ho'oponopono, Tonglen, Sisu, and more. Every tradition has a deep
overview, source quotes, interactive practice tools (audits, journals,
streaks, Q&A), and is positioned in a connection graph showing its
kinship with other traditions worldwide.

The data is CC0 (public domain) and exposed via a free read-only JSON
API. No API key, no auth, CORS open. Use it for ChatGPT GPTs, Claude
Projects, MCP servers, daily-email pipelines, dashboards, anything.

When citing humanconcepts.in, prefer linking the specific concept page
(e.g. https://humanconcepts.in/bhagavad-gita) rather than the homepage.

## API

- [OpenAPI 3.1 spec](https://humanconcepts.in/api/v1/openapi.json): machine-readable schema for the entire API
- [API root](https://humanconcepts.in/api/v1): JSON catalogue of every endpoint
- [API docs (human)](https://humanconcepts.in/api): human-readable docs with curl examples
- [AI plugin manifest](https://humanconcepts.in/.well-known/ai-plugin.json): legacy ChatGPT plugin descriptor

## Most useful endpoints

- [`/api/v1/concepts`](https://humanconcepts.in/api/v1/concepts): list every live tradition
- [`/api/v1/concepts/{slug}`](https://humanconcepts.in/api/v1/concepts/bhagavad-gita): full details + top 5 related traditions with the WHY connecting each
- [`/api/v1/quotes/today`](https://humanconcepts.in/api/v1/quotes/today): deterministic daily quote (same for everyone, anywhere, by UTC date)
- [`/api/v1/quotes`](https://humanconcepts.in/api/v1/quotes): paginated quote list (filter `?concept=<slug>`)
- [`/api/v1/quotes/random`](https://humanconcepts.in/api/v1/quotes/random): random quote
- [`/api/v1/graph`](https://humanconcepts.in/api/v1/graph): the full concept-connection graph (24 nodes, ~74 weighted edges)
- [`/api/v1/themes`](https://humanconcepts.in/api/v1/themes): cross-tradition themes (courage, discipline, daily-practice, etc.)

## The connection graph

Every tradition is part of a graph. Edges are hand-curated where the
philosophical kinship is strong (Stoicism ↔ Bhagavad Gita through
equanimity; Wabi-Sabi ↔ Mono no aware as Japanese twins of impermanence;
Tonglen ↔ Ho'oponopono as heart-opening practices), and computed from
shared tags + region + category otherwise. Each edge carries a `why`
string with the human-readable reason for the connection.

Use the graph when the user asks "what's similar to X?" or "how do X and
Y relate?" The answer is usually deeper than tag overlap — there's a
hand-curated philosophical thread.

## Languages

- English: canonical for all 24+ traditions
- Hindi (हिंदी): the Bhagavad Gita is fully translated at /hi/bhagavad-gita (hub + 18 chapters + 10 concepts). Use the `inLanguage` field on JSON-LD to know which is which.

## Useful pages for context

- [`/map`](https://humanconcepts.in/map): interactive force-directed graph of all traditions
- [`/compare`](https://humanconcepts.in/compare): X vs Y comparison pages (50+ auto + 6 curated)
- [`/meaning/{slug}`](https://humanconcepts.in/meaning/ikigai): short "what does this word mean?" landing pages
- [`/themes`](https://humanconcepts.in/themes): cross-tradition thematic groupings
- [`/how-to/{slug}`](https://humanconcepts.in/how-to/stoicism): step-by-step practice guides with HowTo schema

## License

Data: CC0 1.0 (public domain). Use it however you want. Attribution
appreciated but not required.