Skip to main content

Getting Started

LocalSelf-Host
Fast setup
Interactive provider auth
Manual prompt runs
Recurring scheduling
Full data ownership

Local

Run the full stack on your machine — fastest way to get started with interactive auth and manual runs. Requirements: Node.js 20+, pnpm 10+, Docker
git clone https://github.com/aryamantodkar/oneglanse
cd oneglanse
pnpm install
cp .env.example .env
Set your LLM key in .env (only required value):
# Pick one:
OPENAI_API_KEY=sk-...

# or:
ANTHROPIC_API_KEY=sk-ant-...
ANALYSIS_LLM_PROVIDER=claude
Start the app:
pnpm local
Runs at http://localhost:3000 On first run, OneGlanse:
  • Starts Postgres, ClickHouse, and Redis
  • Runs migrations
  • Bootstraps the browser runtime
Then:
  1. Sign up with email (Google OAuth is enabled only if client ID and secret are configured)
  2. Connect your AI provider accounts (you’ll be redirected automatically)
  3. Add prompts and run

Self-Host

Deploy OneGlanse on your own VPS for scheduled runs and continuous tracking.

1. Deploy

git clone https://github.com/aryamantodkar/oneglanse
cd oneglanse
pnpm install
cp .env.example .env
Update .env:
# Required: analysis LLM
OPENAI_API_KEY=sk-...
# or ANTHROPIC_API_KEY + ANALYSIS_LLM_PROVIDER=claude

# Required: residential proxy
THORDATA_PROXY_API_URL=https://your-thordata-endpoint

# Required: auth upload token
AGENT_AUTH_UPLOAD_TOKEN=your-secret-token

# Optional
APP_URL=https://your-domain.com
API_BASE_URL=https://your-domain.com
Start:
pnpm self-host
Persistent data is stored at /opt/oneglanse/storage

2. Residential proxy

VPS environments are blocked by AI providers — a residential proxy is required. OneGlanse integrates with ThorData:
THORDATA_PROXY_API_URL=https://your-thordata-api-endpoint
PROXY_SCHEME=http
Before each run:
  • OneGlanse fetches fresh proxy candidates
  • Routes browser traffic through one
  • Releases it after completion

3. Provider auth (local → VPS)

Auth must be captured locally and uploaded — it cannot run on a headless server. On your local machine:
ONEGLANSE_VPS_IP=your-vps-ip
AGENT_AUTH_UPLOAD_TOKEN=your-secret-token
Then:
pnpm auth
pnpm upload:vps
Repeat when sessions expire.

4. Run

Open your deployed app, add prompts, and enable scheduling.

Updates

pnpm self-host:app
pnpm self-host:public