Skip to content

Show what Cortex actually looks like, and stop describing it as Ollama-only - #119

Merged
dovvnloading merged 2 commits into
mainfrom
docs/readme-screenshots
Aug 10, 2026
Merged

Show what Cortex actually looks like, and stop describing it as Ollama-only#119
dovvnloading merged 2 commits into
mainfrom
docs/readme-screenshots

Conversation

@dovvnloading

Copy link
Copy Markdown
Owner

Why

The README opened by saying screenshots were "intentionally omitted while the curated capture set is being finalized", and then described an app that only runs Ollama models. Both had drifted from the code.

Screenshots

Three captures of the real build at 1440x900, 2x device scale:

workspace.png Chat library with groups, rendered Markdown, syntax-highlighted code block, per-message footer, composer model picker
settings.png AI Model section — local model picker and generation parameters
command-palette.png Ctrl/Cmd+K over the workspace

The workspace shot is deliberately framed and hovered so the per-message footer is visible — timestamp, token count, tokens/sec, and the copy / regenerate / fork controls. Those are opacity: 0 until a card is hovered, so a naive screenshot silently omits them.

Deterministic by construction

The conversations are a fixed demo workspace (tools/screenshots/demo_server.py), not live model output. No model is contacted during a capture, and every input that could drift is pinned:

  • staged chat content, message ids, and stats
  • a fixed installed-model inventory (independent of what's on the machine)
  • message timestamps derived from each chat's timestamp
  • locale: en-US and timezoneId: UTC — message times go through Intl, so an unpinned zone would change the images per machine

Re-running ./tools/screenshots/capture.ps1 reproduces the same images rather than a fresh set that has to be re-reviewed.

The README states this outright rather than implying the transcripts are genuine model output: the UI is the real build; the conversation content is fixture data.

Corrections to the text

The README had never mentioned the local GGUF runtime. Now documented:

  • .gguf models served by a managed llama.cpp runtime, with llama-server fetched once and verified against a pinned SHA-256
  • GPU backend selection (auto / vulkan / cpu)
  • downloading a GGUF by direct URL or Hugging Face repo
  • Ollama is no longer a hard requirement — Requirements and Quick start updated to say so

Verification

python -m ruff check backend tests tools main.py passes (CI lints tools/). All three image paths resolve from the README; 632 KB total.

🤖 Generated with Claude Code

dovvnloading and others added 2 commits August 10, 2026 10:26
…a-only

The README opened by claiming screenshots were "intentionally omitted while the
curated capture set is being finalized" and then described an application that
only runs Ollama models. Both had drifted from the code.

Adds three captures of the real build -- the workspace, the AI Model settings
section, and the command palette -- taken at 1440x900 on a 2x device scale.
The workspace shot is framed and hovered so the per-message footer is visible:
timestamp, token count, tokens/sec, and the copy, regenerate, and fork controls
that are opacity:0 until a card is hovered.

The conversations behind them are a fixed demo workspace, not live output. No
model is contacted during a capture and every input is pinned -- installed
inventory, settings, message timestamps, locale, and timezone -- so re-running
./tools/screenshots/capture.ps1 reproduces the same images instead of a fresh
set that has to be eyeballed. The images are the real UI; only the conversation
content is fixture data, and the README says so rather than implying otherwise.

Also documents the local GGUF runtime, which the README had never mentioned:
llama.cpp models served by a fetched and SHA-256-verified llama-server, GPU
backend selection, downloading a GGUF by URL or Hugging Face repo, and the fact
that Ollama is no longer a hard requirement.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Rebasing onto main pulled in the system-prompt bypass and the local quality
script, which made two parts of this change stale before it merged.

The AI Model capture is reframed onto the lower half of the panel -- generation
parameters, system instructions, and the new bypass toggle. Model selection is
already visible in the composer of the workspace shot, so nothing is lost by
scrolling past the picker here.

Development checks now point at ./scripts/check.ps1 and the pre-push hook rather
than listing the individual commands by hand.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@dovvnloading
dovvnloading force-pushed the docs/readme-screenshots branch from 648b5ce to fb6d163 Compare August 10, 2026 14:29
@dovvnloading
dovvnloading merged commit 8d65114 into main Aug 10, 2026
1 check passed
@dovvnloading
dovvnloading deleted the docs/readme-screenshots branch August 10, 2026 14:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant