Files

Bundle OKF 0.1 · 3 conceitos · pantelisgeorg/openwiki_bundle

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

About

# Files

- [Ancient Greek Philosophy — research vault quickstart](quickstart.md) - Entrypoint to the OpenWiki research vault covering Ancient Greek Philosophy. Summarizes scope, source inventory, ingestion workflow, operations, and navigation to philosophers, concepts, and sources.

# Directories

- [architecture](architecture/)
- [content](content/)

Details

Kind: OKF bundles
Topic: Files & documents
Publisher: pantelisgeorg
Origin: okf_github
Category: dados
Version: 0.1
Last push: 2026-08-20T18:49:45Z
Repository state: ativo
Language: Python
Added: 2026-09-08 02:26:02
Updated: 2026-09-08 02:26:02
Origin id: pantelisgeorg/openwiki_bundle:openwiki/index.md

README

# Ancient Greek Philosophy Wiki

A personal research wiki covering Ancient Greek Philosophy (Presocratics,
Sophists, Socratic schools, Hellenistic schools), maintained incrementally by
an LLM using [OpenWiki](https://github.com/langchain-ai/openwiki) in code mode.

- **Sources** — the plain-text and Markdown files at the repo root
  (`Anaximandros.txt`, `filosofia.txt`, `filosofia3.md`, `Pythagoras.md`,
  `aristotelis.md`, ...) are what the LLM reads.
- **Generated wiki** — the `openwiki/` directory is synthesized from those
  sources and is hand-readable Markdown you own.
- **Start here:** [`openwiki/quickstart.md`](openwiki/quickstart.md)

## Features

- **Google Open Knowledge Format (OKF)**: Wiki pages follow the
  [Google OKF](https://cloud.google.com/blog/products/data-analytics/how-the-open-knowledge-format-can-improve-data-sharing)
  specification for knowledge sharing.
- **Entity Pages**: People, orgs, places, and products as dedicated wiki pages,
  auto-extracted and kept in sync.

## Local usage

Install OpenWiki once:

```sh
npm install --global openwiki
```

Create `~/.openwiki/.env` with your provider credentials (example — DeepSeek
via the OpenAI-compatible provider, as used for this wiki):

```ini
OPENWIKI_PROVIDER="openai-compatible"
OPENAI_COMPATIBLE_BASE_URL="https://api.deepseek.com"
OPENAI_COMPATIBLE_API_KEY="<your-key>"
OPENWIKI_MODEL_ID="deepseek-chat"
```

From the repo root:

```sh
openwiki code "what do we know about Thales?"   # query the wiki
openwiki code --update --print                  # regenerate/refresh the wiki
openwiki visualize                              # interactive graph + reader in the browser
```

`openwiki visualize` serves the wiki on `http://127.0.0.1:4321` (never exposed
on the network). It needs an internet connection (libraries load from a CDN).

## Static visualizer

`docs/openwiki-visualizer/` is a self-contained snapshot of the graph + reader,
re-exported with:

```sh
node ~/Desktop/openwiki/dist/cli/cli.js visualize openwiki --export docs/openwiki-visualizer
```

The export writes five files: `index.html` (a bare shell), `client.js` and
`client-lib.js` (the app logic), `styles.css`, and `graph.json` (the actual
data — pages and links). The page builds itself in the browser at runtime by
fetching `./graph.json`, so `index.html` looks empty in an editor.

Do **not** open `index.html` by double-clicking it: browsers block `fetch()`
on `file://` URLs, so the graph can't load and the page stays blank. Serve the
directory over HTTP:

```sh
python3 -m http.server 8000 --directory docs/openwiki-visualizer
# then open http://localhost:8000
```

Or enable GitHub Pages (Settings → Pages → Deploy from branch, `/docs`) to
browse it online — Pages serves it over HTTP, so it works out of the box.

## Gephi export

Extract a person/concept graph for [Gephi](https://gephi.org):

```sh
python3 graph_export.py openwiki
```

This writes `gephi_nodes.csv` (Id, Label, Type, Period, Description) and
`gephi_edges.csv` (Source, Target, Type, Weight). To load them:

1. Open Gephi → New Project
2. **File → Import Spreadsheet** → `gephi_nodes.csv` (select "Nodes table")
3. **File → Import Spreadsheet** → `gephi_edges.csv` (select "Edges table")
4. Run a layout (e.g. ForceAtlas 2 or Yifan Hu)
5. Color by Type column, size by degree

The committed CSVs are regenerated snapshots; rerun the script after the wiki
changes to refresh them.

## Auto-update (GitHub Actions)

`.github/workflows/openwiki-update.yml` refreshes the wiki on demand
(workflow_dispatch). It uses the same provider settings as local usage and
needs one repository secret before it will run:

- **`OPENAI_COMPATIBLE_API_KEY`** — your API key (Settings → Secrets and
  variables → Actions)

To re-enable the daily schedule, uncomment the `schedule:` lines in the
workflow.

## How the pieces fit

| Piece | Purpose |
| --- | --- |
| root `*.txt` / `*.md` | Source material the LLM reads |
| `openwiki/` | Generated wiki (content, architecture, quickstart) |
| `AGENTS.md` / `CLAUDE.md` | Pointers for coding agents; OpenWiki maintains them |
| `.github/workflows/openwiki-update.yml` | Scheduled/manual wiki refresh via Actions |
| `graph_export.py` + `gephi_*.csv` | Gephi node/edge export |
| `docs/openwiki-visualizer/` | Static interactive graph (Pages-ready) |

Files

About

Details

README

More