Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[Docs] Linux build instructions missing

Open Beginner friendly
  • Is something wrong?
#3,191 3 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 3 days

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
66/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Active
Tech stack
cpp, linux, python
Domain
backend, build-system, documentation

Research direction

Start by reading the existing Linux build and setup instructions, including update.sh, and check how the monitor TUI is launched through bin/strata. Document the steps to build from Git on Linux and explain how to start the TUI. Done means a Linux user can follow the instructions to build the project and launch the monitor.

Written by the indexing model from the issue text.

Description

I have found this to be a great program.

I can see that a lot of effort has been put into the 2.0 beta. However you have NOT included Linux build instructions. I want to build from GIT. This allows me to easily try PRs and modify code when necessary. Here I added a HIPBLASLT_TUNING table for my 7900xt and made monitor changes along the lines suggested in #1114. Now you want me to use an Appimage. This makes it hard to test to see what tuning options work best on my system and make it hard to make changes and test PRs.

From my POV, using an Appimage is a BIG regression - I moved from LMStudio to llama.cpp for just this reason.

Please include instructions on how to build from git on Linux.

looks like update.sh still works, I have not found any info on how to access the TUI though.

after having the AI dig I find that doing:

/home/ed/builds/Strata/.venv/bin/pip install textual==8.2.8 rich==15.0.0
STRATA_PYTHON=/home/ed/builds/Strata/.venv/bin/python3 /home/ed/builds/Strata/bin/strata monitor --url http://127.0.0.1:8080

lets me run the tui

Thanks

FYI. on 1.45.3 these setting work well (Ryzen 7 7700 96G ddr5-6000 cl36, 7900xt 20G, pci4x4 nvme, B650 MB, on Archlinux Rocm 7.2.4 Kernel 7.3.0 gettng 1550-1800t/s prefill, 70-85t/s decode, with a 70K-110K context running an agentic workflow using letta-code)

"env": {
  "STRATA_HIPBLASLT_TUNING": "/home/ed/builds/Strata/tools/hip/gfx1100-hipblaslt-100202.txt",
  "STRATA_NO_LARGEPAGES": "1",
  "STRATA_IO_THREADS": "64",
  "STRATA_ADAPT_OVERLAP": 1,
  "STRATA_ADAPT_OVERLAP_RESIDENT": 1,
  "STRATA_ROUTE_TAIL_SKIP": 7,
  "STRATA_GDN_HEAD": 1, 
  "STRATA_GDN_PP": 2,
  "STRATA_GDN_CONVL2": 1, 
  "STRATA_GDN_NOY": 1, 
  "STRATA_CVEC_FUSE": 1, 
  "STRATA_Q6_PACKED": 1, 
  "STRATA_MMVF_ROWS": 1, 
  "STRATA_ATTN_LANECELL": 1, 
  "STRATA_EXPERT_V2": 1, 
  "STRATA_TSUM": 1, 
  "STRATA_LFUSE": 1, 
  "STRATA_GDN_SPLIT": 1, 
  "STRATA_QFUSE": 1, 
  "STRATA_PLE_BATCH": 1
 },
Dominant language
C++
Stars
11.6k
Forks
1k
No merged PRs in 30d

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from Niko1221/Strata

All issues in Niko1221/Strata

Similar issues

More C++ issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.