explaingit

laurentongaro/odinrag

Analysis updated 2026-05-18

4PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A personal RAG knowledge base for Odin game development, with Python scrapers to collect docs and AI agent skills to query them.

Mindmap

mindmap
  root((OdinRAG))
    What it does
      Odin game dev knowledge base
      RAG for AI agents
      Human-browsable vault
    Scrapers
      Official docs
      Blog posts
      Paid courses own sub
    AI integration
      Kilo Code skills
      Custom subagent
      MiniMax-M3 built
    Privacy
      Split public private branch
      Gitignored config
      No copyrighted content
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Scrape official Odin documentation and public blog posts into a local knowledge base for offline reference.

USE CASE 2

Query the knowledge base with an AI agent to get Odin game development answers grounded in curated sources.

USE CASE 3

Browse Odin learning material in Obsidian with structured frontmatter and cross-linked INDEX files.

USE CASE 4

Populate the knowledge base with paid course content you already own by running the Skool scraper with your credentials.

What is it built with?

PythonObsidianMiniMax-M3Kilo Code

How does it compare?

laurentongaro/odinragadeliox/klein-head-swapats4321/ragit
Stars444
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity3/53/52/5
Audiencedeveloperdesignerdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Python 3.10+, pip dependencies, and your own subscriptions for paid content scrapers.

Use the scripts and infrastructure freely including commercially, scraped third-party content is not included and remains the property of its authors.

In plain English

OdinRAG is a personal knowledge base for learning and working with the Odin programming language, specifically for game development topics like Raylib, Sokol, hot-reload patterns, and memory allocators. Rather than a runnable program, it is a collection of scrapers, agent skills, and document indexes that help you gather, format, and query learning material about Odin game development. The project supports two styles of navigation: a human browsing through an Obsidian vault or reading INDEX.md files, and an AI coding agent using a set of Kilo Code skills and a custom subagent definition to answer questions about Odin game development. The AI layer uses a RAG approach, meaning the agent can look up specific documents in the knowledge base before answering rather than relying only on its trained knowledge. The repo ships only the workflow infrastructure, not the actual content. Copyrighted material such as a paid Odin book and Skool course transcripts is intentionally excluded. Python scrapers are included for collecting publicly available documentation from official sources, and a separate scraper handles paid content if you have your own subscription. A formatting script cleans up Odin code blocks found throughout the Markdown files. Configuration lives in a single gitignored file so personal paths and credentials never end up in version control. The project uses a split-branch approach: the public GitHub branch contains only sanitized content, while the author maintains a private branch with personal notes and paywalled material that is never pushed to GitHub. The entire project structure, including the scraper architecture, agent prompts, and skill definitions, was designed collaboratively with the MiniMax-M3 AI model through the Kilo Code IDE. The code is released under MIT, the scraped content belongs to its original authors.

Copy-paste prompts

Prompt 1
How do I set up OdinRAG and run the public scrapers to populate the knowledge base without any paid sources?
Prompt 2
How do I configure the Kilo Code subagent in OdinRAG to answer questions about Odin hot-reload patterns?
Prompt 3
What does the split-branch setup in OdinRAG look like and how do I keep my private notes off GitHub?
Prompt 4
How does the format_odin_in_files.py script work and when should I run it?
Prompt 5
How do I add a new public source to OdinRAG by writing a new scraper that follows the existing pattern?

Frequently asked questions

What is odinrag?

A personal RAG knowledge base for Odin game development, with Python scrapers to collect docs and AI agent skills to query them.

What language is odinrag written in?

Mainly Python. The stack also includes Python, Obsidian, MiniMax-M3.

What license does odinrag use?

Use the scripts and infrastructure freely including commercially, scraped third-party content is not included and remains the property of its authors.

How hard is odinrag to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is odinrag for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub laurentongaro on gitmyhub

Verify against the repo before relying on details.