Back to the catalog

inkeep/odyssey-okf-wiki

Bundle OKF 0.2 · 13 conceitos · inkeep/odyssey-okf-wiki

Open source Repository Open in the app JSON README (API)

About

# Index

## Attribution Notice

* [Third-party notices](./THIRD-PARTY-NOTICES.md) - Attribution, provenance, and reuse boundaries for external material in the wiki.

## Code of Conduct

* [Code of conduct](./CODE_OF_CONDUCT.md) - Expected behavior for participants in this repository, and how to report a problem.

## Contribution Guide

* [Contributing](./CONTRIBUTING.md) - How to propose corrections and additions to this wiki, and the sourcing standard every change must meet.

## Document

* [The Odyssey — OpenKnowledge example](./README.md) - A public example of a deeply researched, interconnected OKF knowledge base.

## License

* [License](./LICENSE.md) - Reuse terms for original wiki content and exclusions for third-party material.

## Subdirectories

* [characters](./characters/index.md)
* [external-sources](./external-sources/index.md)
* [reception](./reception/index.md)
* [scholarship](./scholarship/index.md)
* [story](./story/index.md)
* [themes](./themes/index.md)
* [world](./

Details

Kind
OKF bundles
Topic
AI, RAG & memory
Publisher
inkeep
Origin
okf_github
Category
dados
Version
0.2
Stars
8
Last push
2026-08-22T01:17:26Z
Repository state
ativo
License
CC-BY-4.0
Added
2026-09-08 22:07:22
Updated
2026-09-08 22:07:22
Origin id
inkeep/odyssey-okf-wiki:index.md

README

---
type: Document
title: The Odyssey — OpenKnowledge example
description: A public example of a deeply researched, interconnected OKF knowledge base.
tags:
  - readme
  - openknowledge
  - okf
  - odyssey
  - example
---

This repository is a public example of a wiki leveraging the [**Open Knowledge Format (OKF)**](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md) to build a durable knowledge base around a rich subject like Homer's Odyssey. The wiki connects all twenty-four books with character guides, themes, historical and poetic context, translations, adaptations, scholarship, and locally preserved source records.

The wiki was built using the [**OKF Plugin**](https://openknowledge.ai/docs/plugins/okf) for the [**OpenKnowledge app**](https://openknowledge.ai/).

To open the wiki using the OpenKnowledge app directly, use this share [link](https://openknowledge.ai/d/AWh0dHBzOi8vZ2l0aHViLmNvbS9pbmtlZXAvb2R5c3NleS1va2Ytd2lraS9ibG9iL21haW4vUkVBRE1FLm1k).

> Note: OpenKnowledge is a markdown editing app available for Mac, Linux and Windows and has no affiliation with or ownership over Google's Open Knowledge Format.


## Start here

Open [The Odyssey](home.md) for the reader-facing wiki, or inspect the root [OKF index](index.md) to see the portable bundle structure.

## What this example demonstrates

- One Markdown document per useful concept, with typed YAML frontmatter
- Standard Markdown links forming a navigable knowledge graph
- Section indexes and reusable folder templates
- Citations that resolve to local source records rather than to live URLs, so the evidence travels with the bundle — with one disclosed exception, the [reception pages](reception/overview.md), whose subjects are films, novels and comics the repository cannot preserve
- Clear separation between primary texts, metadata-only web sources, and editorial synthesis
- Explicit generation, verification, provenance, and rights metadata
- A chronological [work log](log.md) for durable maintenance history
- Machine-checkable OKF conformance, Markdown quality, and internal-link integrity

The collection is designed to remain readable as ordinary Markdown while gaining richer navigation, templates, provenance, validation, and collaborative editing when opened in OpenKnowledge.

## How this wiki was written

The editorial content here was drafted by an AI agent working using OpenKnowledge OKF plugin, which leverages linting, deterministic rules and automations, a skill and MCP to help agents stay conformant with the spec. Most pages record that origin in their own frontmatter under a `generated:` key, so you can see per document what produced it and when.

That provenance is the point of the example rather than a disclaimer on it: agent-authored knowledge is only trustworthy when every claim resolves to a source a reader can open, and the [verification method](scholarship/verification-method.md) documents how claims here were checked. Treat the pages as a well-sourced reading companion, not as peer-reviewed scholarship — where a page matters to your own work, follow its citation to the underlying text.

## Opening this repo in an agent client

This repository carries a committed [`.mcp.json`](.mcp.json) (and an equivalent `.codex/config.toml`), so Claude Code, Codex, and similar clients will offer to start the OpenKnowledge MCP server when you open the folder. Approving that prompt runs a small shell script that prefers an installed OpenKnowledge desktop app and otherwise falls back to `npx`. The npm fallback is pinned to a version range rather than `@latest`, so what a cloner runs is the range this repository was checked against. Nothing starts without your approval, and the wiki reads perfectly well as plain Markdown if you decline.

## Repository map

| Area | Contents |
| --- | --- |
| [Story](story/overview.md) | Narrative architecture and guides to all twenty-four books |
| [Characters](characters/constellation.md) | Major figures, minor figures, gods, monsters, and communities |
| [Themes](themes/overview.md) | Return, hospitality, cunning, recognition, storytelling, justice, and more |
| [World](world/overview.md) | Composition, poetics, geography, institutions, religion, labor, and objects |
| [Reception](reception/overview.md) | Translations and afterlives across literature, film, television, and art |
| [Scholarship](scholarship/overview.md) | Textual foundations, reading pathways, and verification methods |
| [Sources](external-sources/index.md) | Local primary texts and rights-aware provenance records |

## Reuse

Original wiki-authored content is available under the terms in [License](LICENSE.md) — CC BY 4.0, with the full legal code in [`LICENSE`](LICENSE). Preserved texts, catalog data, names, and linked publications retain their own terms; see [Third-party notices](THIRD-PARTY-NOTICES.md).

## Contributing

Corrections and additions are welcome, and are held to the sourcing standard described in [Contributing](CONTRIBUTING.md). Participation is governed by the [code of conduct](CODE_OF_CONDUCT.md).

More