Follow the evidence. Keep the history of your judgment.
근거를 따라, 판단의 변화를 남기다.

Get started · Features · Verification · Contribute
English · 한국어

---

Your documents change. A result gets revised. A colleague needs to understand why.

THOTH is a local, AI-assisted research workbench that keeps the question, source evidence, competing explanations and recorded results connected. Inspect what supports a judgment, see what remains unresolved, and compare two saved results before deciding what comes next.

_{Original THOTH brand illustration — the Egyptian scribe, reimagined for a research workbench.}

Note

Experimental source preview for personal/local use. The interface is Korean-first. Focused feature and installation checks passed; 25 source-tree regression cases remain unresolved. See status and limits before relying on a result.

What you can do

Follow the evidence	Inspect the judgment	Keep the changes
Connect documents and return to source-located evidence, versions and time eligibility.	Review an answer alongside competing explanations, missing evidence and next actions.	Compare two exact saved results and inspect immutable history. Supported restores create a new revision.

Continue a question without losing its earlier result. Queue new input behind running work; request identity is preserved across retries and recovery.

Keep unresolved work visible. A completed operation can still contain a partial answer or a held judgment. Completion is not a claim that the evidence is sufficient.

Choose your own connection. Configure a supported provider login or API key in your local workspace, then select the model and reasoning setting. Saved choices are preserved; unavailable routes are shown explicitly. Reading a saved result or comparison does not start a model call.

A research loop you can revisit

Step	In THOTH
1 · Ask	Start with a research question and connect the relevant documents.
2 · Inspect	Follow the answer back to evidence; review competing explanations and gaps.
3 · Continue	Add information or a follow-up question. Input can wait behind running work.
4 · Compare	Select two saved results to inspect what changed. Revisit history when needed.

Quick start

Windows · source checkout · Python 3.12 or 3.13 · uv · Node.js · pnpm

Clone the repository:

git clone https://github.com/hyperdrivebeep/thoth.git
cd thoth

Or choose Code → Download ZIP on GitHub, extract it, and open PowerShell in the extracted thoth-main folder. If PowerShell is in the folder containing that extraction, run cd thoth-main. Then install the locked dependencies from the repository folder:

uv sync --frozen --extra dev --dev
pnpm.cmd install --frozen-lockfile

Start the API in one terminal:

.\.venv\Scripts\thoth.exe serve --workspace .\.thoth-local --port 8765

Start the Web interface in a second terminal, after entering the same thoth or thoth-main folder:

pnpm.cmd --dir apps/web run dev

Open http://127.0.0.1:5173/. In setup/settings, select a supported login route or enter your own provider key, then choose a model before starting research. Provider use may consume its quota.

If the backend runs in WSL, complete Codex device login in that WSL terminal with codex login --device-auth. If login is confirmed but no model appears, check the model catalog path in the installation and credentials guide before repeating login.

The API binds to loopback; Vite proxies API calls to port 8765. Keep the migration tree with the source checkout: a standalone wheel is not supported by this preview.

Installation details and optional integrations

The isolated Windows check used Python 3.13.15, Node 24.19.0, pnpm 12.6.0 and uv 0.12.5. The basic PDF path uses pypdf. Structured PDF parsing, browser acquisition, additional connectors and managed sandboxes have optional dependencies and prerequisites.

The default connection does not import OMO credentials. The optional official Codex catalog may read the CLI's local configuration/cache when present. No account configuration is distributed here.

See installation and credentials.

Status

This is an experimental reference implementation, with evidence scoped to the checks below.

Checked locally	Boundary
Input queue, strict input-version checking and exact-result comparison	Four selected integration tests passed; unchanged comparison UI retains recorded Chrome acceptance.
Fresh frozen installation, doctor and Web build	Passed on the recorded Windows environment.
Synthetic evidence interface	36 focused Web tests passed.
First-run Chrome/API smoke	Passed with no credentials or model calls. An unconfigured model was expected.

25 source-tree regression cases remain unresolved. These are separate from the focused feature checks. No complete current-source regression pass is claimed. Some legacy assets are also omitted because their redistribution rights were not established.

Real-provider answer quality, hosted multi-runtime readiness, broad platform portability and actual collaborator time savings have not been established by these checks.

Verification record · Exact known failures · Package boundary

Built to be inspected

Area	Location
Python backend	src/thoth — domain → ports → application → adapters; composition under apps.
React / TypeScript interface	apps/web
Canonical records and versioned history	SQLite, with versioned migrations in migrations.
Brand assets and writing style	docs/brand

UI summaries do not replace canonical records or authorization. Use synthetic data and an isolated workspace for reproductions. Contributions should preserve source-time, scope, currentness and authorization checks. Read the contributor notes before opening a change.

License

Original code, documentation, THOTH brand assets and THOTH-authored synthetic fixtures in this snapshot are available under the MIT License, copyright 2026 THOTH. Dependencies retain their own licenses; see third-party and asset notices.

_{Evidence. Judgment. Revision.}
Built by Hyperdrive