Privacy
Oculon is software you run yourself. It has no account system, no telemetry and no analytics. What it stores stays on the machine that runs it.
No telemetry
No analytics, crash reports or usage pings. Nothing goes to the authors.
Stored locally
One SQLite file in ~/.oculon or your OCULON_HOME.
Keys stay yours
Read from your .env and sent only to the service each key belongs to.
LLMs only if you add a key
ask, case and the brief go to the providers you configured. No key, nothing sent.
Localhost by default
oculon serve listens on 127.0.0.1. Writes need a same-origin request.
No cookies
Only your theme choice, kept in your browser's local storage.
Read from this install's daily usage counters (oculon quota). Requests go only to these services, each under its own terms.
Who this covers
This notice describes how the Oculon software (CLI, SDK, MCP server, this web app and the Telegram bot) handles information. Whoever runs an Oculon install is responsible for that install and for any public deployment of these pages.
What Oculon stores
- A local SQLite database with signals, entities, links, cached API responses, watchlist items, geofences, case files and feedback votes, in
~/.oculonor the folder set byOCULON_HOME. - API keys you add to your
.envfile. They are read locally and sent only to the service each key belongs to. - Nothing is sent to the Oculon authors. There is no usage reporting, crash reporting or tracking.
What leaves your machine
- Queries to public data sources. When a module runs, it calls the sources it needs (for example USGS, Cloudflare Radar, NVD or NASA) with the inputs you gave it, such as a domain, a company or a place name. Each source handles those requests under its own policy.
- Questions to language models. Commands such as
ask,caseand the daily brief send your question and the collected evidence to the LLM providers you configured keys for (Groq, Google Gemini, Mistral, OpenRouter, NVIDIA or Anthropic). Without a key, nothing is sent. - Telegram. If you run the bot, alerts and answers go to the chats you allow-listed, through Telegram's servers.
- This web page. The landing page, app and docs load fonts from Google Fonts, map libraries from cdnjs and map outlines from jsDelivr, so your browser contacts those services when it opens them.
Cookies and browser storage
The pages set no cookies. The app remembers your light or dark theme in your browser's local storage, and nothing else.
Who can reach an install
oculon serve listens on 127.0.0.1 by default, so only the same machine can open it. Actions that change data accept only same-origin requests with a custom header. If you put an install behind a public domain, you decide who can reach it.
Removing data
Delete the Oculon data folder to remove everything it stored. oculon gc trims the cache without removing your watchlist or cases.
Changes
Changes to this notice ship with the software and appear in its documentation.