gitwtfhub

wtf is ui-trading-system?

raahi-bhushan/ui-trading-system — explained in plain English

Analysis updated 2026-05-18

32PythonAudience · generalComplexity · 4/5LicenseSetup · hard

TL;DR

A self-hosted web dashboard that runs automated options trading strategies on NIFTY and SENSEX through your own Zerodha brokerage account.

Mindmap

mindmap
  root((ui-trading-system))
    What it does
      Options trading dashboard
      Live positions and Greeks
      Automated strategies
    Tech stack
      Python
      Flask
      Kite Connect API
    Use cases
      NIFTY SENSEX trading
      GTT monitoring
      Trade journaling
    Audience
      Individual traders
      Algo trading enthusiasts
    Safety
      Dry run mode
      Local only binding
      Trading risk disclaimer

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Monitor live NIFTY and SENSEX option positions with Greeks and margin in one dashboard.

REASON 2

Run automated gap trading or expiry-day strategies against your own Zerodha account.

REASON 3

Test a trading strategy safely in dry-run mode before risking real money.

REASON 4

Use the order placement and Greeks library independently of the web dashboard for a custom trading script.

What's in the stack?

PythonFlaskKite ConnectSQLite

How it stacks up

raahi-bhushan/ui-trading-systemautolearnmem/automembilly-ellis/exr-imageio-poc
Stars323232
LanguagePythonPythonPython
Setup difficultyhardhardmoderate
Complexity4/55/53/5
Audiencegeneralresearcherresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires a paid Zerodha Kite Connect API subscription and careful review of the trading-risk disclaimer before enabling live orders.

MIT license: free to use, modify, and distribute, including commercially, with an added disclaimer that trading real money carries risk the authors are not responsible for.

Wtf does this do

This is a self-hosted dashboard for algorithmic options trading on the Indian NIFTY and SENSEX indexes, built on top of the Zerodha Kite Connect API. It runs entirely on your own machine and connects to your own Zerodha brokerage account, giving you a web interface to view live positions and run several automated trading strategies. The project carries a strong warning: it can trade real money, it is experimental, and the authors accept no responsibility for financial losses. The dashboard shows live NIFTY and SENSEX option positions along with Greeks such as delta and theta, calculated using an embedded Black-Scholes model, and tracks margin. Beyond just viewing positions, it includes several automated strategies: a gap trading module that places linked buy and sell order pairs as prices move, a single leg index strategy called Survivor that rebalances based on delta, an expiry day strategy that reacts to short term candle signals, and pre-market exit orders for options nearing fair value. It also watches for duplicate or stale trigger orders, flags positions with unreviewed exposure, keeps a trade journal that matches buys and sells for profit and loss tracking, supports selling covered calls against held stock, and sends notifications through Telegram and browser push for fills and alerts. To run it, you need Python 3.11 or newer and a paid Zerodha Kite Connect developer subscription for API access. After cloning the repository and installing dependencies, a setup wizard in the browser walks you through entering your API credentials and dashboard login. New installs start in a dry run mode where every order is logged but nothing actually reaches the broker, shown by a dry run badge, until you explicitly switch on live trading. The underlying trading logic, including order placement, an instrument cache, and Greeks calculations, can also be installed and used as a library without the web dashboard. The project is released under the MIT license with an added disclaimer about trading risk, and it is not affiliated with Zerodha. It is aimed at individual traders in the Indian markets who are comfortable running and auditing their own trading code.

Yoink these prompts

Prompt 1
Walk me through setting up ui-trading-system with a Zerodha Kite Connect developer subscription in dry-run mode.
Prompt 2
Explain how the Survivor strategy in this repo uses delta-based rebalancing on a single-leg index position.
Prompt 3
What does the Position Guard module in ui-trading-system flag, and how would I extend it to cover a new symbol?
Prompt 4
Show me how to use just the instrument_cache, positions_lib, and greeks_lib modules from this repo without the Flask dashboard.
Prompt 5
Explain the security steps needed before exposing this dashboard beyond 127.0.0.1, based on this repo's warnings.

Frequently asked questions

wtf is ui-trading-system?

A self-hosted web dashboard that runs automated options trading strategies on NIFTY and SENSEX through your own Zerodha brokerage account.

What language is ui-trading-system written in?

Mainly Python. The stack also includes Python, Flask, Kite Connect.

What license does ui-trading-system use?

MIT license: free to use, modify, and distribute, including commercially, with an added disclaimer that trading real money carries risk the authors are not responsible for.

How hard is ui-trading-system to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is ui-trading-system for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.