Know what would change your mind.
Reviso is a research notebook for a stock idea you already have. You write the idea, name the conditions that would make you reconsider, check those conditions against a dated company filing, and record the decision yourself. It cannot place a trade.
Live demo: https://revisoagent.xyz
This is a working research product for Bitget AI Base Camp Season 2 (AI Trading Desk / Decision Stress Testing). It is not an investment adviser, brokerage, or signal service. Tokenized Bitget products in the demo give economic exposure to a company. They are not registered shares in your name.
- A private library of ideas, versions, evidence checks, conversations and decisions
- Six checked companies, each bound to one Bitget Reality instrument and one official evidence path
- A rules-based finding from reported numbers, not from a model vote
- Qwen as an explainer beside the result, not as the decision
- Exports of a saved version as Markdown, JSON or PDF
Public pages (/, /guide, /example, /privacy, /terms) are read-only. They do not read your notebook and do not call Qwen. Saved research lives behind Google sign-in at /app.
- Pick a company. Choose NVIDIA, Apple, Microsoft, Alphabet, Amazon or Tesla. Each card shows the Bitget tokenized pair Reviso has verified for that issuer.
- Write the idea. Explain why you are interested and what would make you reconsider. You can write the conditions yourself or ask Qwen for an editable draft. Saving a draft does not freeze anything. Confirming does: that version stays in the history.
- Check the evidence. Reviso fetches the allowlisted filing and a separately dated Bitget USDT observation, then compares only compatible reported metrics. Missing numbers stay missing. Qwen can explain the saved excerpts. It cannot change 74.6 versus 75.
- Decide. Keep, change or set aside the idea, in your own words. Later edits create a new version. The earlier conditions, finding and decision remain attached to the version they belonged to.
New research is a short path: Choose → Explain → Review. After confirmation the saved record is a workspace: Idea → Conditions → Evidence → Decision.
A complete written NVIDIA case, with no live fetch and no Qwen call, is at /example. The product walkthrough is at /guide.
Sponsored Bitget Qwen 3.8 Max is the first language-model route. Qwen 3.8 27B on Groq is a fallback. Qwen can:
- turn a rough idea into editable conditions
- explain how a saved filing relates to those conditions
- answer follow-up questions using citations from that filing
Qwen cannot confirm conditions, fetch an arbitrary website, compute the financial result, record keep / change / set aside, or place a trade. Repair attempts count toward the daily allowance. If Qwen is offline or the allowance is used, you can still finish the path by hand. Saved findings stay readable.
Reviso only fetches allowlisted hosts and paths. External text is data, never instructions. Financial arithmetic uses Decimal. Absent observations stay absent.
| Kind of data | Role |
|---|---|
| Official company filing | The source for company conditions |
| Bitget Reality USDT observation | Dated market context for the selected instrument, not a finding |
| xStocks indicative USD price | Separate comparison context for the same company. Never filing evidence, never a substitute for the Bitget quote |
| Historical NVIDIA replay | Labeled history for the prepared example. Not current evidence for a live check |
| Controlled numerical stresses | Explicit scenarios, not forecasts |
Supported means the available filing supports that specific condition. Invalidated requires a confirmed floor and a reported number that misses it. One missed floor does not rewrite the other comparisons. An older report is not promoted as a successful current check. Guidance and non-GAAP figures cannot fill a missing GAAP fact.
Reviso does not claim that a token equals company shares, tracks the listed stock one-for-one, or can be redeemed.
An issuer is enabled only when both a Bitget market identity and an official evidence path are in code.
| Company | Bitget instrument | Current company evidence | What numerical conditions can use |
|---|---|---|---|
| NVIDIA | rNVDA / USDT (RNVDAUSDT) |
Newsroom earnings release; matching SEC company facts only if that path fails | Reported GAAP gross margin and year-over-year revenue growth, plus manual research |
| Apple | rAAPL / USDT (RAAPLUSDT) |
SEC company facts | Reported GAAP gross margin and year-over-year revenue growth, plus manual research |
| Microsoft | rMSFT / USDT (RMSFTUSDT) |
SEC company facts | Reported GAAP gross margin and year-over-year revenue growth, plus manual research |
| Alphabet | rGOOGL / USDT (RGOOGLUSDT) |
SEC company facts | Year-over-year revenue growth, plus manual research |
| Amazon | rAMZN / USDT (RAMZNUSDT) |
SEC company facts | Year-over-year revenue growth, plus manual research |
| Tesla | rTSLA / USDT (RTSLAUSDT) |
SEC company facts | Reported GAAP gross margin and year-over-year revenue growth, plus manual research |
Exact identities, metric limits and source URLs are in stock coverage. The evidence contract is in data and evidence policy.
Each signed-in person has a separate library. Identity is Google’s stable sub. Email is display data and does not merge accounts. Ideas, versions, evidence checks, chats and decisions are stored under an internal Reviso user id. Another signed-in person cannot open that record.
The illustrated face on the account control is generated in the browser from DiceBear Fun Emoji artwork (CC BY 4.0). The account id is used only as a local seed.
Public demo mode requires Google sign-in, HTTPS origin/host allowlists, CSRF on mutations, and Qwen usage limits. Shared HTTP Basic is not an access path. Loopback development uses an explicit local identity and must never be a production fallback.
Browser (React, Vite, TypeScript)
│
▼
FastAPI ── SQLite (immutable versions, owner-scoped rows)
├── Bitget public market (official SDK, read-only)
├── NVIDIA newsroom / SEC company facts
├── xStocks public USD context
└── Qwen extract/review (Bitget first, Groq fallback); Groq chat and drafts
Contracts, providers, numerical engines, services and the SQLite repository stay separate. The browser never receives provider keys. Production serves the built web app and /api from one origin behind Caddy on AWS Lightsail. SQLite and TLS certificates live on named Docker volumes. One application replica is required while SQLite is the store.
Prerequisites: Python 3.12 through uv, and Node.js 22.13 or newer. From this repository root:
uv sync --frozen
npm ci
cp .env.example .envStart the API:
uv run uvicorn backend.api:app --host 127.0.0.1 --port 8000 --reload --env-file .envStart the frontend:
npm run devOpen http://127.0.0.1:5173. Loopback uses an explicit local identity. API docs are at http://127.0.0.1:8000/docs in local mode only; they are disabled in public demo.
The public Bitget SDK bridge needs outbound access to api.bitget.com. Failures produce unavailable observations, not invented values. Private thesis text is not sent to Bitget.
A production-shaped container that binds only to loopback is documented in deployment:
docker compose build
docker compose upThen open http://127.0.0.1:8080. Do not publish that listener.
Copy .env.example to a Git-ignored .env. Do not put secrets in VITE_* variables, chat, or the image.
| Variable | Purpose |
|---|---|
BITGET_QWEN_API_KEY |
Sponsored Qwen 3.8 Max. Loaded from .env or the process environment. An exported process value wins. The endpoint and model id are fixed in backend code. |
GROQ_API_KEY |
Filing follow-up chat (Groq Qwen 3.8 27B) and condition drafts (gpt-oss-20b). Also the extraction/review fallback if Bitget is unset. REVISO_LLM_MODEL changes the Groq chat id; REVISO_DRAFT_MODEL changes the Groq draft id. |
REVISO_DB_PATH |
SQLite file. Default data/reviso-v1.sqlite3. Migrations run on startup. |
REVISO_AUTH_MODE |
local (default on loopback), google, or simulated. Public demo cannot use local or simulated. |
REVISO_GOOGLE_CLIENT_ID |
Public Google web client id. Required for Google sign-in and for public demo. |
REVISO_PUBLIC_DEMO |
1 only behind HTTPS with explicit hosts, origins, Google sign-in and Qwen limits. |
REVISO_QWEN_USER_DAILY_LIMIT / REVISO_QWEN_TOTAL_DAILY_LIMIT |
Public-demo allowances. Repair attempts count. |
For local Google sign-in, Google Cloud must list both http://127.0.0.1:5173 and http://localhost:5173 as Authorized JavaScript origins. Production uses https://revisoagent.xyz.
uv run ruff check backend tests
uv run ruff format --check backend tests
uv run pytest -q
npm test
npm run format:check
npm run typecheck
npm run buildTests establish behavior. They do not establish research accuracy. Mechanical quality scans are recorded in quality. Live Qwen batches and browser journeys are recorded in evaluation. No general accuracy score is claimed from those runs.
- Six companies, not an open equity universe
- Suggestion-path timeouts and some contract rejections remain disclosed product risk
- Qwen streaming is untested
- Safari / Firefox and a newcomer user study have not been done
- There is no administrative audit UI and no encrypted database backup beyond host snapshots
- Automatic Lightsail snapshots are off until billed storage is approved