An agent-first Chromium browser that turns web research into instant, visual, alive intelligence.
Powered by Cerebras-speed inference  ·  Built on Gemma 4  ·  Designed for the Cerebras × Gemma 4 Hackathon

---

Preview

New tab landing with browser chrome	Predictive cursor shaping intent while typing

---

What is Velox?

Velox is a Chromium-based desktop browser where AI agents are first-class citizens — they live in real tabs, browse real pages, and show you their work in real time.

Most AI search tools wait until you hit Enter. Velox starts shaping intent while you're still typing, running bounded research agents that open, read, scroll, and summarize live web pages. A synthesis agent gathers everything into a clean, visual answer with sources, citations, and an inspectable browsing trace.

The result: deep research that feels dramatically faster than traditional AI search — because the browser itself becomes a transparent, continuously thinking workspace.

Hackathon origin: Built for the Cerebras × Gemma 4 Hackathon. Without a CEREBRAS_API_KEY, Velox falls back to a demo-compatible flow so judges can explore the full UI without configuration.

Product flow at a glance

Typing in omnibox
  ──► /api/predict          intent + confidence + waste guard
  ──► optional speculative  /api/research/start
  ──► committed research    visible Chromium tabs open / read / scroll / summarize
  ──► /ws session_update    real-time stream
  ──► source shelf          evidence with citations
  ──► answer canvas         synthesized answer with export

---

Features

🔮 Predictive intent Velox predicts what you're researching while you type, launching speculative agents before you finish your query.	👁️ Visible agent tabs Each research agent runs in its own visible browser tab. Inspect its goal, events, and links. Take over to continue manually.
📸 Live browsing evidence Agents capture screenshots, extract text, rate source credibility, and build an evidence trail you can see — not a black box.	🧠 Synthesis canvas A dedicated synthesis agent gathers all research into a clean, visual answer with inline citations, summaries, and browsing trace.
📤 Export anywhere Export answers as Markdown or JSON. Persisted session snapshots let you pick up where you left off.	⚡ Cerebras-speed inference Powered by Cerebras hardware and Gemma 4, delivering fast, on-device-style inference for real-time prediction and synthesis.

---

Visual identity

Velox's identity is built on the predictive cursor mark — three forward-advancing cursor shapes that represent the prediction, research, and synthesis phases of the research flow.

Color palette

Role	Hex	Preview
Brand blue	#2931ff
Brand indigo	#4b1dff
Brand dark	#070813
UI accent	#6366f1
UI cyan	#22d3ee
Surface	#0a0a12
Ghost glow	#eef0ff

Typography

Role	Font
UI	Inter
Answer canvas	Merriweather
Code	JetBrains Mono

Brand assets

Asset	File	Usage
Logo lockup	./apps/renderer/src/assets/velox-logo.svg	Landing page, marketing
Standalone mark	./apps/renderer/src/assets/velox-mark.svg	In-app mark, favicon context
Favicon	./apps/renderer/public/favicon.svg	Browser tab icon
macOS icon	./build/icon.icns · ./build/icon.png	Packaged .app icon

---

Architecture

The system is composed of four layers that work together seamlessly:

Layer	Technology	Responsibility
Desktop shell	Electron 42	Window management, packaged app lifecycle, native OS integration
Renderer	React 19 + Vite 8	Browser chrome, omnibox, agent tab workspace, answer canvas, source shelf
Agent server	Express 5 + WebSocket	Prediction API, research lifecycle, settings, session persistence, real-time streaming
Research runtime	Playwright + Chromium	Page navigation, content extraction, screenshots, action traces

API endpoints

POST /api/predict             Intent prediction from partial query
POST /api/research/start      Begin a research session
POST /api/research/demo       Demo-mode research walkthrough
POST /api/research/:id/commit  Commit a speculative run
POST /api/research/:id/cancel  Cancel an active run
POST /api/research/:id/export  Export session as Markdown/JSON
WS   /ws                      Real-time session state stream

---

Quick start

# Clone and enter
git clone https://github.com/ezzy1630/Velox.git
cd Velox

# Install dependencies
pnpm install

# Configure environment
cp .env.example .env

# Install Playwright browser binaries
pnpm run setup:browsers

# Launch dev mode (server + Vite + Electron)
pnpm run dev

pnpm run dev starts three processes concurrently:

Process	URL
Agent server	http://127.0.0.1:8787
Vite dev server	http://127.0.0.1:5173
Electron shell	Desktop window → renderer

One-command boot

./boot up
# or
pnpm boot up

This installs dependencies, builds Velox, packages the local macOS .app, and opens Velox.app — all in one command.

---

Demo

No-key judge path

pnpm run dev

1. Click Menu → Try a demo research run.
2. Show the browser-shaped shell: tabs, omnibox, live workspace.
3. Click Inspect on an agent tab to see its goal, events, and links.
4. Click Take over to show the manual-handoff state.
5. Review source notes, answer canvas, citations, and export.

Suggested demo query:

compare Cerebras Gemma 4 multimodal inference with normal AI search for browser agents

Live Cerebras path

cp .env.example .env
# Add CEREBRAS_API_KEY=sk-...
pnpm run setup:browsers
pnpm run dev

---

Scripts

Command	Description
pnpm run dev	Server + Vite + Electron (concurrent)
pnpm run build	Typecheck + server build + renderer build
pnpm run typecheck	TypeScript type checking
pnpm run package:dir	Local .app folder (unsigned)
pnpm run package	Distributable Electron artifacts
pnpm boot up	Build, package, and open Velox.app
pnpm run check	Typecheck + smoke + build + e2e demo
pnpm run smoke	Validate prediction contract behavior
pnpm run e2e:demo	No-key research session E2E test
pnpm run setup:browsers	Install Playwright Chromium
pnpm run start:app	Production server + Electron

---

Environment

Click to expand environment variable reference

Variable	Default	Description
CEREBRAS_API_KEY	—	Cerebras inference API key
CEREBRAS_MODEL	gemma-4-31b	Model identifier
MAX_AGENT_TABS	8	Maximum concurrent agent tabs
MAX_SPECULATIVE_TABS	2	Pre-commit speculative tabs
MAX_CONCURRENT_TABS	3	Parallel page navigations
MAX_SEARCH_QUERIES	4	Search queries per session
AGENT_REQUEST_TIMEOUT_MS	18000	Agent timeout
SEARCH_REQUEST_TIMEOUT_MS	9000	Search timeout
SEARCH_REQUEST_CONCURRENCY	3	Parallel search limit
SEARCH_PROVIDER	duckduckgo	Search backend
SEARCH_CACHE_TTL_MINUTES	30	Search cache lifetime
SESSION_UPDATE_DEBOUNCE_MS	140	WS update throttle
SOURCE_CACHE_WRITE_DELAY_MS	900	Source persistence delay
MAX_SCREENSHOTS_PER_TAB	1	Screenshots per agent tab
SOURCE_CACHE_TTL_HOURS	72	Source cache duration
PERSISTENT_BROWSER_CACHE	true	Reuse browser profile
AGENT_IGNORE_HTTPS_ERRORS	false	Bypass TLS errors
MAX_DAILY_SEARCH_REQUESTS	500	Daily search rate limit
MAX_DAILY_PAGE_NAVIGATIONS	800	Daily navigation limit
MAX_DAILY_MODEL_REQUESTS	1000	Daily model call limit
SESSION_HISTORY_LIMIT	24	Persisted sessions
ENABLE_VISUAL_ANALYSIS	true	Page screenshot analysis
DEMO_MODE_ENABLED	true	No-key demo path
VELOX_DATA_DIR	.velox-data	Data directory
VELOX_NODE_BINARY	(auto-detect)	Node.js binary path

---

Packaged app

# Build renderer + server + local .app
pnpm run package:dir
open release/mac-arm64/Velox.app

# Build distributable artifacts
pnpm run package

Packaging uses electron-builder with an unpacked asar: false configuration so the bundled server resolves runtime dependencies from Resources/app/node_modules.

---

Roadmap

• Live tab takeover — Full bidirectional control of the Playwright browser page from the Electron UI
• Source conflict detection — Intelligent disagreement and contradiction spotting across sources
• Signed distribution — Notarized macOS builds and code signing
• Durable browser profiles — Cookies, downloads, session history persistence
• Collaborative answers — Shared sessions and multi-user answer canvases

---

References

Document	Description
ARCHITECTURE.md	Deep-dive into system design
docs/API.md	Full API reference
PRODUCT.md	Product vision and philosophy
PRODUCT_SPEC.md	Detailed product specification
HACKATHON_SUBMISSION.md	Hackathon submission notes
ROADMAP.md	Long-term development plan
DEMO_SCRIPT.md	Demo walkthrough script
RESEARCH_NOTES.md	Research and design decisions

---

_{MIT  ·  © 2026 Velox contributors}