> ## Documentation Index
> Fetch the complete documentation index at: https://solo-09d10f60.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Enoch docs

> The Enoch documentation website: learn the control plane, run a smoke test, deploy safely, and review generated-artifact provenance.

# Enoch docs

This is the **Enoch documentation website**. Use it to learn what Enoch is, run a local smoke test, deploy the control plane and worker, configure required tokens safely,
and review generated research artifacts without losing provenance boundaries.

Enoch is an agentic research control plane. It queues research ideas, checks whether a worker is safe to use, supervises long-running local AI jobs, preserves evidence, and packages AI-generated research artifacts with explicit provenance.

These docs are written for new operators, contributors, and reviewers. They are intentionally conservative. When a behavior is not evidenced in the code repository,
corpus repository, Hugging Face export, or release notes, the docs either omit it or call it a limitation.

The hosted docs website is [https://solo-09d10f60.mintlify.app/](https://solo-09d10f60.mintlify.app/). The source lives in [`alias8818/enoch-docs`](https://github.com/alias8818/enoch-docs). The application code lives in
[`alias8818/enoch-agentic-research-system`](https://github.com/alias8818/enoch-agentic-research-system). Generated artifacts live in
[`alias8818/enoch-ai-research-corpus`](https://github.com/alias8818/enoch-ai-research-corpus).

## What you are looking at

<CardGroup cols={2}>
  <Card title="Documentation website" icon="book-open" href="https://solo-09d10f60.mintlify.app/">
    The hosted Mintlify site explains the system, deployment path, API surface, and provenance rules.
  </Card>

  <Card title="System repository" icon="code" href="https://github.com/alias8818/enoch-agentic-research-system">
    The FastAPI control plane, dashboard, deployment scripts, tests, and launch-site source live here.
  </Card>

  <Card title="Research corpus" icon="database" href="https://github.com/alias8818/enoch-ai-research-corpus">
    Generated research artifacts, evidence bundles, claim ledgers, manifests, and packaging/provenance reports live here.
  </Card>

  <Card title="Launch site" icon="globe" href="https://alias8818.github.io/enoch-agentic-research-system/">
    A short public project overview with architecture diagrams and highlighted generated artifacts.
  </Card>
</CardGroup>

## Start here

<CardGroup cols={2}>
  <Card title="1. Understand the system" icon="map" href="/introduction">
    Learn what Enoch does, what it does not claim, and how the control plane fits with the corpus.
  </Card>

  <Card title="2. Run a local smoke test" icon="terminal" href="/quickstart">
    Clone the code repo, create a local config, start the FastAPI app, and verify the Dashboard V2 + bounded v1 API path.
  </Card>

  <Card title="3. Deploy carefully" icon="server" href="/deployment">
    Follow the two-machine reference deployment for a control VM and worker-gate node.
  </Card>

  <Card title="Runtime snapshot" icon="network" href="/current-runtime-snapshot">
    Check the canonical current hosts, storage authority, worker path, and compatibility boundaries.
  </Card>

  <Card title="4. Review provenance" icon="file-check" href="/reference/authorship-provenance">
    Use the correct authorship and citation framing for generated research artifacts.
  </Card>

  <Card title="5. Understand the quality floor" icon="shield-check" href="/concepts/quality-floor">
    Separate operational health, useful signal, paper readiness, and public trust posture before judging output.
  </Card>
</CardGroup>

## Common operator tasks

<CardGroup cols={2}>
  <Card title="Dispatch a research run" icon="play-circle" href="/guides/dispatch-flow">
    Run preflight checks, validate the queue, dry-run the candidate, and only then enable live dispatch intentionally.
  </Card>

  <Card title="Generate paper artifacts" icon="file-text" href="/guides/paper-artifacts">
    Sync evidence, generate draft artifacts, and run packaging/provenance checks before release.
  </Card>

  <Card title="Configure Enoch" icon="settings" href="/configuration/overview">
    Set required fields, worker connection, alerts, and paper-writer provider settings without committing secrets.
  </Card>

  <Card title="Set up queue alerts" icon="bell" href="/guides/alerts">
    Enable Pushover notifications for queue hangs and stoppage detection.
  </Card>

  <Card title="Read the API reference" icon="code" href="/reference/api-endpoints">
    Use the source-grounded endpoint reference for the documented FastAPI surface.
  </Card>

  <Card title="Open the docs source" icon="github" href="https://github.com/alias8818/enoch-docs">
    Edit the MDX source and propose corrections in the GitHub repository.
  </Card>
</CardGroup>

## Release-safe framing

<Warning>
  Enoch-generated reports are AI-generated research artifacts for inspection, replication, and critique. They are not peer-reviewed or human-authored papers.
  Keep claims tied to run notes, evidence bundles, claim ledgers, and packaging/provenance reports before sharing artifacts externally. Use the [quality-floor contract](/concepts/quality-floor) to decide whether a record is a paper-corpus artifact, a promising signal, or an internal archive item.
</Warning>