{
 "schema_version": 1,
 "generated": "2026-10-20",
 "id": "yamz-labs-kyojin--run-local-openai-compatible-server",
 "repo": "Yamz-Labs/kyojin",
 "repo_url": "https://github.com/Yamz-Labs/kyojin",
 "repo_slug": "yamz-labs-kyojin",
 "title": "Run a local OpenAI-style LLM server on AMD",
 "page_title": "How to run a local OpenAI-style LLM server on AMD with Kyojin",
 "summary": "Serve a 95 GB Qwen model on one 128 GB AMD mini PC through an OpenAI-compatible API on port 8000.",
 "who": "A developer or small team that wants to point existing OpenAI API client code at a model hosted on their own AMD Strix Halo machine instead of a cloud service.",
 "problem": "Cloud model APIs send data off the machine and bill per request, and most large models do not fit on a single consumer box.",
 "outcome": "A local server on port 8000 that answers OpenAI API requests using a 300B-class MoE model class on one machine.",
 "steps": [
  "Install ROCm torch and build Kyojin once by following doc/install.md.",
  "`git clone https://github.com/Yamz-Labs/kyojin && cd kyojin`",
  "`hf download yamz-labs/Qwen3.8-Flash-Next-EXL3-Yamz --local-dir ./qwen-pack`",
  "`python tools/qwen/serve.py --model ./qwen-pack --port 8000 -c 131072`",
  "Point your OpenAI API client at port 8000 on the machine and send a test chat request."
 ],
 "agent_prompt": "In the Yamz-Labs/kyojin repo, follow doc/install.md, then download the Qwen3.8-Flash-Next pack and start tools/qwen/serve.py on port 8000 on <target host>. Expected output: the server starts and answers one OpenAI API chat request with text. Verify that the response JSON includes a choices array before reporting success.",
 "agents": [
  "any"
 ],
 "difficulty": "Intermediate",
 "time": "2 hours",
 "basis": "readme",
 "caveat": "The README says the software targets AMD Strix Halo with ROCm (gfx1151), so it will not run on other hardware as documented.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "python",
 "requirements": [
  "AMD Ryzen AI Max+ 395 mini PC with 128 GB of memory (Strix Halo, gfx1151)",
  "ROCm build of torch, installed per doc/install.md",
  "Python and the hf command-line tool to download model packs",
  "Roughly 100 GB of free disk space for a model pack (Qwen pack is 95 GB)"
 ],
 "risk": "dual-use",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": true,
 "score": 1.0,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/yamz-labs-kyojin/run-local-openai-compatible-server/",
 "md": "https://dedupedai.com/use-cases/yamz-labs-kyojin/run-local-openai-compatible-server/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/yamz-labs-kyojin--run-local-openai-compatible-server.json",
 "api_version": "v1"
}
