Druks Panel

Druks Panel turns an important question into an inspectable decision process. Three independent advisors examine opportunity, risk, and execution. A moderator combines their arguments. Then the workflow parks until a human selects proceed, revise, or pass.

The app has one subject, one workflow, four agents, three pages, and one human gate. This small scope makes it a clear example of a Druks app. Druks Panel remains separate from the framework.

What it demonstrates

decision
   ├─ opportunity advisor
   ├─ risk advisor
   └─ execution advisor
            ↓
        moderator
            ↓
   durable human decision

The example includes:

• A separate app package that uses druks.apps
• Strict structured outputs for each agent
• Durable orchestration across agent calls and persistence steps
• A subject-backed gate that can remain parked across restarts
• App-owned models, migrations, HTTP routes, prompts, and declared pages

The screens are Python. druks_panel/pages.py declares them with druks.ui, and the Druks dashboard renders them. The app ships no JavaScript. Each page is a pure read. The board follows every decision. A decision page follows its own row. Thus both redraw as each advisor reports.

Druks reuses completed durable operations when a workflow recovers. An operation that stops before completion can run again. Thus, this app does not claim exactly-once external effects.

Install for development

Clone Druks and this repository into adjacent directories. Then install Panel in the Druks environment:

git clone https://github.com/czpython/druks.git
git clone https://github.com/czpython/druks-panel.git
cd druks
uv sync --dev
uv pip install -e ../druks-panel

Use the development guide to start the Druks development stack. Restart Druks after the installation. Druks finds the entry point and shows Panel in the app switcher.

For an image deployment, extend the Druks image. Install the package in its existing virtual environment:

FROM ghcr.io/czpython/druks:latest
RUN uv pip install "git+https://github.com/czpython/druks-panel.git"

Use that image for the Druks web service. Run druks init-db. Restart the service. Connect a model provider in Settings before you start a panel.

Use

Open Panel in the Druks dashboard. The board opens first. Select New decision. Enter the decision and its context. Then start the deliberation. Open the decision from the board. A card appears for each advisor as it reports. When the run parks, read the synthesis. Then record the human outcome on the same page. The Druks Dashboard also lists the waiting decision and opens this page. Each assessment, the synthesis, and the recorded outcome appear in Activity.

Agent defaults use standard Druks agent settings. An operator can change the model, effort, and timeout for each advisor in the dashboard. This change does not require a package change.

Develop

This repository has no tests. The gates are the linter, the formatter, and the type checker:

uv sync --dev
uv run ruff check .
uv run ruff format --check .
uv run pyright

Druks checks the rest at boot. It refuses the app if a page route, a navigation entry, or an action that names a route operation does not resolve.