2.3 KiB
2.3 KiB
ThothII documentation
ThothII is a human-reviewed datamart builder. It turns a question into validated SQL through an eight-phase workflow: the model proposes; a reviewer makes the decisions that are persisted.
Start with the path that matches the work you need to do:
| I need to… | Start here |
|---|---|
| Install or operate one instance | Install and first start |
| Clone and manually install on macOS, Windows, or Linux | Italian procedure · English procedure |
| Upgrade the server and integrate Omics Portal | Codex server handoff |
| Choose full/embedded and configure the shell | Shell and localization |
| Reuse an authenticated server portal without a second login | Upstream authentication |
| Understand how the two renderings share the same application | Rendering architecture |
| Validate login, logout and portal integration before release | Acceptance matrix |
| Add, update, or prepare a workspace | Workspace operations |
| Ask a question and review the SQL workflow | User guide |
| Configure and refresh an authoritative database catalog | Database management |
| Author and publish domain Evidence | Evidence |
| Understand boundaries and persistence | Architecture overview |
How the documentation is organised
- Install and operate documents host-side setup, authentication, lifecycle, workspaces, and Pi administration.
- Use ThothII documents the two application paths: reviewed NL→SQL sessions and administrative database management.
- Architecture and contracts explain why the system behaves as it does and define the machine-facing boundaries. Consult them when integrating or changing an implementation; they are not a substitute for an operator runbook.
The host-side tht command is the operator interface. The Python tht inside harness/ is a
different, internal workflow CLI invoked by the core. In examples, use an absolute installation
descriptor path whenever discovery is not unambiguous.