Repository navigation
Home
Kuray Karaaslan edited this page Oct 5, 2026
·
1 revision
Tepegoz is a local-first, security-first agentic browser: a desktop browser shell with an AI agent that can plan, act on web pages, pause for human approval, and leave an audit trail.
This wiki is the public handbook. It summarizes the product, points to the source-of-truth files in the repositories, and keeps the important caveats visible: Tepegoz is pre-release, unsigned, not independently audited, and the agent's competence is still measurement-owed.
- Project Status - what works, what is unproven, what is not built.
- Product Overview - what Tepegoz is and the principles behind it.
- Getting Started - requirements, install, build, launch, and first-run notes.
- Using the Agent - plan preview, tool use, approvals, budgets, and auditability.
- Known Issues and Troubleshooting - common problems and current gaps.
- Browser Features - browser shell, pages, downloads, uploads, bookmarks, tasks.
- Privacy and Data - local data, exports, backups, provider data flow.
- Network Privacy - per-tab and per-group VPN/Tor/SOCKS routing.
- Releases and Builds - build status, unsigned installers, release expectations.
- Architecture Overview - L0-L10 layers, packages, boundaries, data flow.
- Security Model - trust boundaries, policy kernel, HITL, egress, reporting.
- Development Guide - setup, scripts, contribution rules, quality gates.
- AI and Model Gateway - BYO-key providers, routing, token ledger, limits.
- Website Guide - static Next site, source-copy model, checks, deployment.
- Website Content Map - public routes, statuses, assets, translations.
- Wiki Page Plan - page backlog, audience map, and fill order.
- Product repo: https://github.com/kuraykaraaslan/tepegoz-browser
- Website repo: companion
tepegoz-browser-websiterepository