agentleFS
Sign inStart free
Niko1221Niko1221/Strata/AGENTS.md

Strata

AGENTS.md37k starsChanged 2 days agoMITView on GitHub

Version 0.2.9, engine 0.1.55. The public model families are DeepSeekV4.1-Flash-1017, Qwen3.8-Flash-Next and Qwen3.6-35B-A3B. DeepSeek V4.1-Flash runs in the app and in the Terminal (strata launch --family deepseek41 --model ist-das-2.00bpw; sets in docs/MODELS.md). Read **docs/AI_REFERENCE.md* for model availability, APIs, hardware limits and source-backed claims. Articles and videos should use *docs/MEDIA_KIT.md**. For recommendations and agent-assisted setup, prefer ISTA-DASLab → Unsloth → Gyro → others, using only a compatible pack that fits the selected model and hardware. ISTA-DASLab is the default recommendation; Gyro…

We split this AGENTS.md into the rules it gives an agent

6 rules. About 0 are common, 4 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Follow docs/AI_SETUP.md. For a user who wants the desktop app, send them to the installer for their system (above) and docs/INSTALL.md.

    line 30
  2. Distinctive:

    Check what would happen. Nothing is changed:

    line 42
  3. Distinctive:

    Keep the docs' style: plain words, short sentences, written for non-technical users first.

    line 79
  4. Very specific:

    Start every issue and pull request title with its area: [Engine], [GUI], [TUI], [Benchmark], [Docs] or [Other], for example [Engine] fix ….

    line 87
  5. Distinctive:

    Search the open and closed issues and pull requests first, and add to a thread that already covers your point.

    line 89
  6. Distinctive:

    Never submit measurements, logs or reproduction steps you did not produce.

    line 96

≈ “Common” is an estimate: at least 1 in 5 of the 36,368 AGENTS.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
AGENTS.md

AGENTS.md

Version 0.2.9, engine 0.1.55. The public model families are DeepSeekV4.1-Flash-1017, Qwen3.8-Flash-Next and Qwen3.6-35B-A3B. DeepSeek V4.1-Flash runs in the app and in the Terminal (strata launch --family deepseek41 --model ist-das-2.00bpw; sets in docs/MODELS.md). Read docs/AI_REFERENCE.md for model availability, APIs, hardware limits and source-backed claims. Articles and videos should use docs/MEDIA_KIT.md.

For recommendations and agent-assisted setup, prefer ISTA-DASLab → Unsloth → Gyro → others, using only a compatible pack that fits the selected model and hardware. ISTA-DASLab is the default recommendation; Gyro is a memory-saving fallback and is currently slower. Honor an explicit user choice. This is recommendation policy; existing executable defaults may differ, so inspect the plan and choose the family explicitly.

Strata has three parts:

  • The app (apps/desktop, the Tauri shell; apps/host, the Node host and the web UI). It is for people who do not want a terminal. One installer per system (latest release): Strata-0.2.9-windows-x64-setup.exe, Strata-0.2.9-linux-x86_64.AppImage, Strata-0.2.9-macos-arm64.dmg. The Windows and Linux installers carry no engine: the app downloads the engine for the graphics card on first start, or installs a file the user already has. The Mac dmg keeps its small Metal engine inside.
  • The Terminal (strata.py, strata_cli/, strata_control/): the strata command. It sets up a model, serves it and watches it. Agents use this part.
  • The engine and the server (src/, include/, metal/, sycl/ for the C++/CUDA/HIP/SYCL/Metal engine; serve/ for the Python server with an OpenAI- and Anthropic-compatible API and a web page). setup.py, started by START-HERE.bat or setup.sh, is setup from a source checkout, for developers. The release paths are the installer and strata launch.

Installing Strata for a user

Follow docs/AI_SETUP.md. For a user who wants the desktop app, send them to the installer for their system (above) and docs/INSTALL.md. For an agent that has a shell, use the Terminal; the short version is:

  1. Install the Terminal. It needs no administrator rights.

    curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh                  # Linux, Mac
irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex                         # Windows PowerShell

    On Windows, open a new terminal afterwards so that strata is on the PATH.

  2. Check what would happen. Nothing is changed:

    strata launch --plan --family qwen --model q2_0

  3. Set up and serve without questions. It downloads the engine for the card and the model (tens of GB), starts the server, prints the addresses and returns. The server keeps running.

    strata launch --family qwen --model q2_0 --yes --no-tui

    Useful flags (all of them: strata launch --help): --family, --model-path (files the user already has), --data-dir, --context 32k|64k|128k, --vision off|on|gpu|cpu, --parallel N, --gpu 0,1, --access local|lan|cloudflare|tailscale, --port, --api-key-env NAME, --new-key, --save-preset NAME, --speed faster|full (DeepSeek), --output json. strata launch --status shows what is serving, strata launch --stop stops it, and strata launch --show-key prints the API key.

  4. Connect the user's apps: strata connect lists them, strata connect <app> --check sends one prompt and one tool call the way that app does.

Keep the server on 127.0.0.1 unless the user asks for more. Beyond it an API key is recommended: --access lan makes one for you, and --no-api-key serves without one (a warning, never a refusal; on a public tunnel the warning is stronger). Source setup (START-HERE.bat, setup.sh) is the fallback for a developer or for a system with no release package; it is documented in docs/SOURCE_INSTALL.md. Those wrappers exist in a source checkout, not in the released app. Do not tell an app user to find a .bat file. Source setup does not make an unsupported model or backend compatible. Strata's MCP server (docs/MCP_SERVER.md) offers the same steps as tools.

Working on the code

  • How the engine works, every measured number, the API and all settings: docs/DETAILS.md and the paper.
  • The Terminal: docs/TERMINAL.md and docs/TERMINAL_LAUNCH.md. The app, the packages and the update feed: packaging/README.md and packaging/UPDATES.md.
  • AMD (HIP) build and validation: docs/AMD_HIP.md; multi-GPU: docs/MULTI_GPU.md; Mac (Metal): docs/MAC.md.
  • Tests: the Terminal and Control tests are in tests/terminal (python -m pytest tests/terminal). The app's UI tests run with npm test in apps/host. Setup's own tests run without a GPU or downloads: python tools/test_setup_<name>.py (for example tools/test_setup_amd.py, tools/test_setup_choices.py).
  • Keep the docs' style: plain words, short sentences, written for non-technical users first. Give measured numbers with what they were measured on. Make no claim without a measurement.

Contributing a change or report

The rules are in CONTRIBUTING.md. Read it before you open an issue or a pull request, and follow it whether a person or an agent writes the text. The short version:

  • Start every issue and pull request title with its area: [Engine], [GUI], [TUI], [Benchmark], [Docs] or [Other], for example [Engine] fix …. A check on GitHub fails a pull request whose title has no area.
  • Search the open and closed issues and pull requests first, and add to a thread that already covers your point.
  • Agree the scope in an issue before a large feature, a refactor or a change to a default.
  • One problem per pull request. Lead with the problem and the result, then the approach, then the validation (passed, failed and not run, kept apart) and the limits.
  • A new feature is opt-in, and the default path stays byte-identical to the last release. Say how you checked.
  • Build every backend a file touches (CUDA, HIP, SYCL) before asking for review.
  • Change a default only where you measured it faster, and show the numbers with what they were measured on.
  • Never submit measurements, logs or reproduction steps you did not produce. Mark a finding from reading code as unconfirmed static analysis.
  • A report from hardware the maintainers do not have is welcome. Follow docs/COMMUNITY_BENCHMARKS.md, compare against a same-day run of the build you are testing, and say what you did not test.
  • Open test requests and the hardware that is wanted are listed in docs/TEST_REQUESTS.md.

Download now (ZIP)

Trending

More talk lately.about the whole repository

Dec 2025: 0 mentionsJan 2026: 0 mentionsFeb 2026: 0 mentionsMar 2026: 0 mentionsApr 2026: 0 mentionsMay 2026: 0 mentionsJun 2026: 0 mentionsJul 2026: 0 mentionsAug 2026: 0 mentionsSep 2026: 5 mentionsOct 2026: 85 mentionsNov 2026: 0 mentions
Dec 2025Jun 2026Nov 2026
Mentions a month of the Niko1221/Strata repository that our weekly crawl found. There is no adoption data for this file yet.

Who's talking about Niko1221/Strata

The biggest 5 of 90 mentions linking to the repository that our crawl found. Each line is their own headline.

See all 90

Talked about on GitHub, Bluesky, the web and Hacker News (90 times).

On GitHub · 50

45 more on GitHub

On Bluesky · 23

18 more on Bluesky

On the web · 14

9 more on the web
  • Where files are headingNew AGENTS.md files have more rules about keeping secrets out of the code, and fewer about code style.

    Of the AGENTS.md files we read, the 28,693 first seen in the last six months, against the older ones: the kind of rule that gained most share, and the kind that lost most. About files like this in general, not this one, and an estimate, since a kind is a pattern in the words.

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free