theia

KO | EN

gitlite — search

#javascript #hacktoberfest #llm #go #deep-learning #java #windows #awesome #cli #kubernetes #vue #pytorch #ios #open-source

(★ 14)

a visualization of your Hermes Agent activity

theia Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# theia

![theia icon](https://raw.githubusercontent.com/arm64be/theia/main/icon.png)

Visualize Hermes agent sessions as a semantic constellation.

- `theia-core/` — Python build tool: Hermes SQLite DB → `theia-graph.json`
- `theia-panel/` — TypeScript panel: `theia-graph.json` → three.js constellation
- `schemas/graph.schema.json` — contract between the two halves

## Install

The fastest way to install theia:

```bash
curl -fsSL https://raw.githubusercontent.com/arm64be/theia/main/install.sh | sh
```

See [`docs/quick-start.md`](docs/quick-start.md) for alternative install methods, prerequisites, and configuration.

## Documentation

| Document | Description |
|---|---|
| [`docs/quick-start.md`](docs/quick-start.md) | Installation guide and prerequisites |
| [`docs/usage.md`](docs/usage.md) | CLI, Makefile, and installer reference |
| [`docs/build-pipeline.md`](docs/build-pipeline.md) | End-to-end build pipeline reference |
| [`docs/integration.md`](docs/integration.md) | Hermes dashboard integration guide |
| [`docs/updating.md`](docs/updating.md) | How to update theia |
| [`docs/troubleshooting.md`](docs/troubleshooting.md) | Common problems and solutions |
| [`docs/demo-script.md`](docs/demo-script.md) | 3-minute demo walkthrough script |
| [`docs/superpowers/specs/2026-04-21-theia-design.md`](docs/superpowers/specs/2026-04-21-theia-design.md) | Architecture design spec |

## Project structure

```
theia/
├── theia-core/              # Python package — SQLite → graph.json
├── theia-panel/             # TypeScript package — graph.json → constellation
├── plugin/                  # Hermes dashboard plugin
├── schemas/
│   └── graph.schema.json    # Contract between core ↔ panel
├── examples/
│   ├── sessions/            # Sample Hermes session JSONs
│   └── graph.json           # Canonical golden fixture
├── docs/                    # Documentation
├── icon.png                 # Project icon
├── install.sh               # One-command installer
└── Makefile                 # Build targets
```

theia

theia Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

theia

theia Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README