Your growth data, on your own machine — ask it anything in plain English.
Infinite OS is a self-hosted, local-first growth-analytics runtime. It connects your data sources — Google Analytics 4, PostHog, Stripe, Meta, Shopify, and read-only X public post metrics — into a Postgres database on your own machine, keeps it synced, and lets you ask questions like "how many page views in the last 7 days?" or "which channels drove the most traffic?" and get real answers from governed, source-accurate metrics.
🌐 Site: infinite.fast · 𝕏 Project: @InfiniteOS_ · Maker: @RiverKhan
It is
nota broad agent runtime, skill platform, or generic SQL tool. For natural-language questions it forwards your prompt to your own Claude or Codex account using your own credentials; it executes no tools or shell commands. Your data never leaves your machine unless you send it somewhere.
Everything runs locally as one small stack:
Postgres— your synced growth data, sync state, jobs, schedules, and queryable views (a rebuildable cache; the source of truth stays with the providers).app daemon— a local HTTP API the CLI talks to.** worker**— owns the scheduler and runs syncs as background jobs.** CLI (**— the operator shell + the chat interface.infinite
)encrypted connector credentials— provider keys/tokens are encrypted at rest with yourGROWTH_OS_ENCRYPTION_KEY
.
You connect a source once, sync it, then ask questions. Answers come from a typed metric layer with authority/provenance rules — not free-form SQL — so a number is either source-accurate or honestly reported as unavailable.
Once a source is connected and synced, just ask — in plain English:
"How many page views did I get in the last 7 days?""What were my top pages this week?""Which channels drove the most traffic last month?""How many new users this week vs last week?""What's my engagement rate over the last 30 days?"**"How much revenue did I make in the last 30 days?"(Stripe)"Compare this week's traffic to the previous week."
Infinite figures out the right metric, runs it against your synced data, and answers with the numbers + a short read — citing the source and flagging anything it can't verify (it won't guess).
Install with one command (macOS / Linux). It checks you have git, Node ≥ 20, and pnpm (it won't install or change them for you), puts Infinite at ~/.infinite/app
, drops an infinite
command on your PATH, and runs setup:
curl -fsSL https://raw.githubusercontent.com/Infinite-Labs-AI/infinite-os/main/scripts/install.sh | bash
Then:
infinite setup # connect a data source + configure the model, and start the local stack
infinite # ask a question
infinite "how many page views in the last 7 days"
git clone https://github.com/Infinite-Labs-AI/infinite-os.git infinite
cd infinite
./infinite setup
./infinite
setup
installs/builds the workspace if needed, configures model auth, and starts the bundled Docker stack.
| Command | What it does |
|---|---|
infinite |
|
| Start an interactive session (ask questions in natural language) | |
infinite "<question>" |
|
| Ask one question and print the answer | |
infinite setup |
|
| Connect a data source, configure the model, start the stack | |
infinite setup status |
|
| Show what's ready and what's blocked | |
infinite connect <provider> |
|
Connect/reconnect a source (ga4 , posthog , stripe , x , …) |
|
infinite sources |
|
| List connected sources | |
infinite sync [provider] [window] |
|
Sync data (windows: incremental , 30_days , 3_months , all_time , …) |
|
infinite metrics / explain <metric> |
|
| List metrics / explain a metric's authority & provenance | |
infinite version |
|
| Print the version and commit | |
infinite start / stop / status / logs [service] |
|
| Manage the local Docker stack | |
infinite update |
|
| Pull the latest code on this branch and restart | |
infinite help |
|
| Full command list |
Connectable: Google Analytics 4 · PostHog · Stripe · Meta · Shopify · X (read-only public post metrics). Deeper attribution and content analysis are on the roadmap.
GA4 and PostHog only start collecting data once their tracking tag is on your website. After infinite setup
connects an analytics source, install the tag into your own site's repo with our published npm package, — it uses only your
infinite-tag
public keys, auto-detects your framework, and writes idempotent, fully reversible changes:
npx infinite-tag@latest install
infinite setup
prints a ready-to-paste npx infinite-tag install …
command with your Measurement ID / PostHog key and workspace id already filled in (and saves your public keys to ~/.infinite/artifacts/
, so a bare npx infinite-tag install
discovers them automatically). See for all flags and the supported frameworks (Next.js, Vite + React, static HTML).
packages/instrument/README.md
infinite setup
writes your config and secrets into a gitignored .growth-os/
directory; connector credentials are encrypted at rest. Your data stays on your machine — nothing is sent anywhere unless you do it. See SECURITY.md for the trust model and the full variable list.
pnpm install
pnpm typecheck
pnpm test
See docs/local-and-docker-quickstart.md for the Docker path, CONTRIBUTING.md to contribute, and SECURITY.md to report a vulnerability.
MIT © Ultima AI, Inc.