FlintTrade

FlintTrade is self-hosted trading software for Indian markets. It supports manual, automated, algorithmic, and AI-assisted workflows from a browser, with an optional desktop shell around the same backend. The FlintTrade backend serves the terminal and API from a single origin (port 5100).

Practice mode and example data work without a broker. The public roadmap is ROADMAP.md.

Pre-release

FlintTrade v0.0.1 is pre-release software and is not production ready. Trading involves the risk of loss. Nothing in this repository is financial, investment, tax, legal, or regulatory advice. Read disclaimer.md before enabling Live mode.

Project scope

• Terminal app — React 19, TypeScript, FlexLayout, FDC3, Zustand, TanStack Query, and shadcn/ui components for a local workspace.

• Backend services — Python 3.14 Flask routes for auth, workspace state, broker-gateway orchestration, sandbox data, analytics, and automation.

• Safety model — Practice and Live are session modes. Connected (read) is a broker status. Example is sample data. Server-side checks, audit records, and a kill-switch boundary for order-capable routes.

• Data and simulation — DuckDB/Parquet storage, indicator packages, backtest services, and a Rust/PyO3 tick-processing engine.

• Developer tooling — the cross-platform scripts/ft.py runner (with make as its POSIX alias), pytest/Vitest/Playwright suites, packaging scripts, CI notes, and package-level documentation.

Supported brokers

Broker connections use six native adapters: Dhan, Upstox, Kotak Neo, INDmoney, Groww, and Delta Exchange. A broker session cannot be started from the terminal today. Practice mode and example data work without a broker. Broker writes return 503 and broker reads return 409. Live order placement stays disabled unless it is explicitly unlocked and every safety layer passes.

Supported versions

Each runtime has a floor and a target. The floor is the lowest version that must work. The target is what development and CI exercise. Both are declared once, in flint.toml's [requirements] table. tests/test_minimum_requirements_single_source.py fails if a manifest disagrees with that table.

	Floor	Target
Python	>=3.14	3.14
Node	>=22.23.4	24
Linux	Ubuntu 26.04 LTS	26.04
macOS	macOS 13+	universal .dmg
Windows	Windows 10/11 x64	.exe and PowerShell installers

Python's floor and target are the same 3.14 series. Node's floor is 22.23.4, and its target stays ahead at 24. Electron 45.2.3 bundles Node 24.22.2.

Ubuntu 26.04 LTS is the Linux floor because that release ships Python 3.14. The Ubuntu floor applies only to Linux source installs. macOS 13+ ships as a universal .dmg. Windows 10/11 x64 ships as an .exe and through the PowerShell installer, with ARM supported through emulation.

The one-line installer provisions its own Python, Node and pnpm under ~/.flinttrade/tools. The Python and Node floors apply to source installs and contributors on every platform.

Quickstart

Install (recommended — no prerequisites)

FlintTrade runs as a self-hosted web app: one backend process serves the terminal UI and the API on a single origin, and you use it from any browser. The one-line installer runs in the shell your OS already ships — bash or zsh on macOS and Linux, built-in PowerShell on Windows — and needs no other toolchain: no Python, no Node, no git and no make.

# macOS / Linux
curl -fsSL https://flinttrade.vercel.app/web-install.sh | bash

# Windows 10/11
# Run in a normal (non-Administrator) PowerShell window
irm https://flinttrade.vercel.app/web-install.ps1 | iex

It provisions a pinned, checksum-verified toolchain — uv, Python 3.14, Node and pnpm — under ~/.flinttrade/tools, builds FlintTrade from a managed source checkout at ~/.flinttrade/web-src/FlintTrade, and installs a flinttrade-web launcher (~/.local/bin/flinttrade-web on macOS and Linux; %LOCALAPPDATA%\Programs\FlintTradeWeb\flinttrade-web.cmd plus a FlintTrade Web Start Menu shortcut on Windows). The Electron desktop shell keeps its own launcher and source checkout, so the two installs never collide. Open http://127.0.0.1:5100 and complete the in-app Setup flow — no .env file is required.

Uninstalling keeps your workspace and data:

# macOS / Linux
curl -fsSL https://flinttrade.vercel.app/uninstall.sh | bash

# Windows 10/11
irm https://flinttrade.vercel.app/uninstall.ps1 | iex

Add the purge flag — --purge on POSIX, -Purge on Windows — to delete recognised FlintTrade data too. Purge is irreversible and asks for explicit confirmation:

# macOS / Linux
curl -fsSL https://flinttrade.vercel.app/uninstall.sh | bash -s -- --purge

# Windows 10/11
& ([scriptblock]::Create((irm https://flinttrade.vercel.app/uninstall.ps1))) -Purge

If the site is unreachable (repo-direct fallback)

Use this whenever a flinttrade.vercel.app command fails: those URLs are only a redirect to the scripts in this repository, and a site outage or a deployment without an immutable source commit answers 503, which curl … | bash would otherwise pipe into your shell as an error page. The commands below fetch the same two scripts straight from GitHub and depend on no deployment:

# macOS / Linux — install
curl -fsSL https://raw.githubusercontent.com/navaneeshnagarajan/FlintTrade/main/scripts/install/flinttrade-web-install.sh | bash

# Windows 10/11 — install
# Run in a normal (non-Administrator) PowerShell window
irm https://raw.githubusercontent.com/navaneeshnagarajan/FlintTrade/main/scripts/install/flinttrade-web-install.ps1 | iex

This is the beginning of the README. Read the rest at the original. Read the full README ↗