Reading the repo
Reading the repo
Fresh setup, read just now
Will it work on my device?
CONTRIBUTING.mdThanks for your interest in contributing! This project is licensed under AGPL-3.0.
git clone https://github.com/<you>/G0DM0D3.gitnpm install.env.example to .env and add your API keysnpm run devsrc/api/server.tsHF/git checkout -b feat/my-featurefix: resolve CORS on /chat endpoint)mainOpen a GitHub issue with:
By contributing, you agree that your contributions will be licensed under the AGPL-3.0 license.
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
git clone https://github.com/elder-plinius/G0DM0D3.git cd G0DM0D3
Node.js LTS (no version pinned), Python 3
# needs nvm: https://github.com/nvm-sh/nvm nvm install --lts sudo apt install python3 python3-pip
npm ci
npm run dev
Visit godmod3.ai — no install needed. Bring an OpenRouter key, a Venice key, connect a local OpenAI-compatible server, or configure more than one of those providers.
The standalone interface is a single index.html file with no build step or package install.
# Clone the repository
git clone https://github.com/elder-plinius/G0DM0D3.git
cd G0DM0D3
# Open directly in your browser
open index.html
# or serve locally
python3 -m http.server 8000
Open it in your browser and configure OpenRouter, Venice, or local models in Settings. A static-only deployment can run the chat UI, but /api/telemetry will not publish metadata unless you also deploy functions/api/telemetry.ts on Cloudflare Pages and configure its Hugging Face variables.
G0DM0D3 supports OpenAI-compatible model servers running on your own hardware. For example, with Ollama:
ollama pull qwen3:8b
ollama serve
Open Settings → API Keys → Local Models, enter http://localhost:11434/v1, then click Test & Discover Models. Enable Local-only mode to exclude OpenRouter and Venice model calls and automatically disable G0DM0D3 app telemetry. Add multiple model IDs to race them together in ULTRAPLINIAN.
If you use the hosted site, your local server must allow browser CORS from https://godmod3.ai. For a completely self-hosted setup, serve this repository locally as shown above. See LOCAL_MODELS.md for Ollama, LM Studio, troubleshooting, and privacy details.
Upload index.html to any static host — GitHub Pages, Vercel, Cloudflare Pages, Netlify, or a web server. To reproduce the hosted telemetry pipeline, deploy on Cloudflare Pages with functions/api/telemetry.ts; see the comments at the top of that file for configuration.
No reports for Linux yet.
Opens a chat with this manual already filled in, for Linux. It uses your own account; gitmanual sends nothing.