Reading the repo
Opening the box…
Reading the repo
Opening the box…
Assembly instructions
Every analytics tool wants a subscription. And your data. I built Twiligent instead. YouTube stats. Instagram stats. One dashboard. Runs locally on your machine.
Saved setup from just now
Will it work on macOS?
Heads-upIt also needs 18 settings in .env (7 secret).
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.
Needs Git: xcode-select --install
git clone https://github.com/spacesdrive/twiligent.git cd twiligent
Node.js >=22.18.0
# needs nvm: brew install nvm (or https://github.com/nvm-sh/nvm) nvm install --lts
npm ci
npm run dev
npm test
You can use Twiligent in two ways.
If someone gave you a link to their Twiligent, sign in there. There is nothing to install. Start with Sign in and first steps.
You need a free Cloudflare account, a free Supabase project and the API keys for the platforms you want. The self-hosting guide walks through every key, step by step.
To try it on your own machine first, you need Node.js 22.18 or newer:
git clone https://github.com/spacesdrive/twiligent.git
cd twiligent
npm install
npm run dev
The dashboard opens at http://localhost:5173. It needs a few keys in backend/.dev.vars before it can load data; Environment variables lists each one.
No reports for macOS yet.
GitManual AI Agent reads the 9 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.