FAQ

Straight answers to the obvious questions about Forven — is it local, is my money safe, does it auto-trade, what does it cost, will it make me money.

Short, honest answers to the questions most people ask first. Forven is a local-first desktop quant research lab: it helps you build, test, kill, and promote trading strategies through a disciplined walk-forward gauntlet before any real capital is involved. If you want the longer version of any answer, the linked pages go deeper.

This page covers live trading, risk, and results, so the plain version up front: Forven is a research tool. Backtest and paper results are not predictive of future performance, and nothing here is financial advice.

The basics

Is Forven really local?

Yes. Forven runs entirely on your machine. The backend (FastAPI), the UI (SvelteKit), the database (SQLite), and the semantic memory store (ChromaDB) all live on your computer under a single workspace directory, FORVEN_HOME (defaults to ~/.forven). That directory holds your forven.db, config.json, auth tokens, and research artifacts.

There is no Forven cloud doing your research. The only network calls Forven makes are the ones you'd expect from a tool that studies markets: pulling market data, talking to your chosen LLM provider (if you use the Forged agent layer), and — only when you explicitly go live — sending orders to the exchange.

Where does my data live?

In FORVEN_HOME. A typical layout:

# Default workspace location on Windows
echo $env:USERPROFILE\.forven
# Contains: forven.db, config.json, auth.json, chromadb/, and your datasets

You can point FORVEN_HOME somewhere else with an environment variable before launch. Your strategies, backtests, and settings never leave that folder unless you move it.

Is my money safe? Is my account safe?

Forven cannot touch money it has no keys for. There are several deliberate layers between you and an accidental trade:

Beta builds hard-lock to paper. During the beta, execution mode is forced to paper (local simulation) regardless of config. The lock is enforced at the point where the code reads the mode, so a stale live value left in config.json can never take effect.
Live (mainnet) is default-deny. Even outside beta, real-money execution on HyperLiquid requires you to set FORVEN_ALLOW_MAINNET=1 explicitly. The default is 0.
Your exchange keys stay on your machine. HyperLiquid credentials are read from environment variables, a local file (~/.forven/hyperliquid.json), or encrypted settings — never sent anywhere but the exchange itself. Set FORVEN_ENCRYPTION_KEY to encrypt secrets at rest.
Hard risk controls. A kill-switch, daily-loss halt, drawdown limit, and per-trade risk cap sit in front of every order.

See Going live safely for the full pre-capital checklist.

Cost & licensing

Is Forven free?

During the beta, yes — the lab is free and beta accounts have everything unlocked. There are two tiers:

Core (free during beta): the full local lab plus the autonomous research daemon.
Forged: adds the AI agent layer and bring-your-own-key (BYOK) model routing.

Beta entitlements report the forged tier, so you can use the agent layer while we're in early access. See Core vs Forged for what's in each.

Do I have to pay Forven for AI usage?

No. Forven never resells model tokens. The agent layer is bring-your-own-key: you connect your own provider account, and you pay that provider directly for what you use. Forven routes requests; it doesn't mark them up. See Models & providers (BYOK).

Do I need an LLM key at all?

Not for the core lab. You can ingest data, backtest, run the gauntlet, and paper-trade with no LLM key whatsoever. An LLM key is only needed for the Forged features: the agents, the research daemon's autonomous ideation, and the deep-dive strategy chat.

How it trades

Does Forven auto-trade my money?

No — not in beta, and not by default after. A few things have to be true at once before a single real order can be placed:

You are on a build where live mode is permitted (beta builds refuse).
You have set FORVEN_ALLOW_MAINNET=1.
You have switched execution mode to live.
A strategy has actually survived the pipeline and been promoted to the live stage — usually with operator approval.

Read Execution modes: paper vs live for how the switch works and why it's gated.

What exchanges does Forven support?

Live order routing goes to HyperLiquid (testnet by default, mainnet only when you explicitly allow it). For market data — the candles you backtest against — Forven supports several sources including Binance/CCXT, Binance Vision, Polygon, Yahoo, and CSV import. Data sources and live execution are separate concerns.

What's the difference between paper and live trades?

Paper trades fill against your local OHLCV candle prices and are recorded in SQLite only. No order ever reaches the exchange. They run in isolated per-session sandboxes.
Live trades are real orders placed on HyperLiquid, filled at exchange prices, carrying real order IDs.

Because paper fills use local mid-prices, paper PnL is not a one-to-one proxy for live PnL — there's no slippage against a real order book, no exchange queue. Treat paper as a discipline check, not a profit forecast. More in Paper trading.

If I do go live, what stops a runaway loss?

Several hard controls, enforced before and during execution:

Control	Default	What it does
`max_drawdown_pct`	`10`	Trips the kill-switch and flattens all positions when portfolio drawdown breaches it
`max_daily_loss_pct`	`5`	Halts new trades for the rest of the UTC day once same-day realized loss breaches it
`max_risk_per_trade_pct`	`2`	Rejects any single order risking more than this share of the account
Circuit breakers	per-breaker	Pause exchange calls when HyperLiquid itself is unhealthy (true outages, not rate-limits)

The kill-switch is autonomous: it can flatten positions without waiting for you. Values above are illustrative defaults — you configure them in Settings. See Risk controls and Going live safely.

Platform & support

Is it Windows-only?

The desktop app ships for Windows today (Forven-Setup-x.y.z.exe). macOS support is planned. See Install for the current download and setup steps.

The installer warns about an unknown publisher — is that a problem?

The beta installer isn't code-signed yet, so Windows SmartScreen may flag it. That's expected for an early-access build, not a sign of compromise. The Install page walks through the exact prompts.

Something's broken — where do I start?

The Troubleshooting & recovery page covers the common ones: the scheduler stuck on a stale lock, the daemon offline, a blocked approval queue, and MCP connection problems. For day-to-day health, the /ops dashboard and its soak report tell you what's green, amber, or red.

Results & expectations

Will Forven make me money?

No one can promise that, and Forven won't pretend to. Forven is a research instrument, not a money machine. Its job is to make your process honest: to test strategies out-of-sample, to surface overfitting, and to kill ideas that only looked good in-sample.

The whole design assumes that in-sample metrics lie and that the only durable retail edge is disciplined process. Any number you see in the app — a backtest Sharpe, a paper PnL curve — is an artifact of historical or simulated data and is illustrative only. It does not predict the future. See Philosophy for why the tool is built to be skeptical of its own results.

Why does it keep killing my strategies?

Because that's the point. A strategy must survive the gauntlet — walk-forward analysis, parameter jitter, and cost-stress testing, scored for robustness — before it earns a paper slot. Implausibly good metrics are treated as suspicious, not impressive: a profit factor at or above the lookahead ceiling, or a Sharpe past the implausible ceiling, triggers an automatic reject because they usually signal a future-bar leak. Forven would rather disprove your darling cheaply than fund it expensively.

A note on the names

The marketing site uses simplified words for the pipeline. The app uses the real engineering names, and so do these docs:

public "screen" is the quick_screen overfitting gate
public "candidate" is the paper stage
public "gauntlet" and "live" mean what they say

Wherever a public synonym helps, we note it once and then use the real name.

The honest caveat

Forven is a research tool. Backtest and paper results are simulations of the past, are not predictive of future performance, and nothing in this documentation is financial advice. Live trading risks real capital; the safety controls reduce risk but cannot eliminate it. Go slow, stay in paper while you learn, and decide for yourself.

Philosophy — why the tool is built to doubt its own numbers
Core vs Forged — what each tier includes during beta
Execution modes: paper vs live — paper simulation vs real orders
Going live safely — the checklist before any real capital

On this page