Skip to content
View Am1n1602's full-sized avatar
😉
😉

Highlights

  • Pro

Block or report Am1n1602

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
Am1n1602/README.md

Aman Gautam

Software developer and student at IIT (BHU) Varanasi.
Systems programming, data and machine learning, and games.

LinkedIn Email X itch.io

GitHub followers

About · Projects · Games · Tech stack · Activity · Contact

About

I'm in the pre-final year of an Integrated Dual Degree at IIT (BHU) Varanasi. I like software that sits close to how things really work: network clients, data pipelines, game loops. Most of my code is in Rust, Python, TypeScript and C++, and I pick whichever fits the problem.

One habit I try to keep is checking my assumptions against reality before I build on top of them, and having a program say "I don't know" instead of guessing. In practice that has meant testing against live responses, storing missing values as null with a reason attached, and writing down what I found rather than what I assumed.

Selected projects

Project What it is Built with
Fin_QA Question answering over NSE and BSE filings, with a deterministic financial engine under the LLM Python, FastAPI, React, PostgreSQL
jugaad-rs NSE market data as a Rust library, a CLI, a gRPC server and a Python package Rust, tokio, tonic
Audio Notes Platform Upload a recording, get a transcript and a structured summary Next.js, FastAPI, PostgreSQL, Cloud Run
OpenTerminal Indian-market data layer for an open-source terminal-style dashboard (a fork) TypeScript, Next.js, Express

Live demo CI License

Ask it "Compare RELIANCE and ONGC on leverage" or "Why did HCLTECH's profitability decline?" and it answers with the calculation behind every number and the filing passage behind every claim. It covers all 50 NIFTY 50 companies.

  • The language model never computes or invents a figure. A plain Python engine does the arithmetic over normalised XBRL data, and the model only writes up what the engine and the retrieval layer produced, citing the evidence for each sentence.
  • A separate verification pass recomputes the calculations and checks every citation before an answer goes out. If it can't confirm something, the answer is downgraded or the system abstains. A metric that can't be computed cleanly comes back as null with the reason, never as zero or an approximation.
  • On my 51-question regression set, run with no LLM calls, numerical accuracy and claim groundedness are both 100%, correct abstention is 98.0% and overall correctness is 86.1%. There is also an 850-question internal benchmark and 547 unit tests.
  • One result surprised me: plain BM25 beat both dense and hybrid retrieval on this corpus (Recall@5 of 68.2% against 40.9% for dense and 50.0% for hybrid). I put it down to near-duplicate boilerplate across quarterly filings diluting embedding similarity. A cross-encoder reranker helped at pilot scale, but it stays off by default until I've re-validated it on the full corpus.
  • The demo runs on Cloud Run and Firebase Hosting, both scaled to zero, so the first visit after a quiet spell waits about two minutes while the 261,479-chunk corpus loads.

CI Release PyPI License

A Rust rewrite of the Python jugaad-data library for downloading historical and live data from the National Stock Exchange of India. One core library, used four ways: as a Rust crate, through a 47-command CLI that writes CSV, through a gRPC server with 10 RPCs that is published as a container image, and from Python through sauda, a pip package that bundles the server and starts it for you.

NSE has no official API documentation, so I checked every endpoint against live responses, including a retest while the market was open, and logged what I found in docs/nse-findings.md. The project's rule is to verify NSE behaviour live before writing code around it, not to infer it from the Python library.

  • Transient failures are retried with exponential backoff and jitter. A 403 from NSE's bot protection comes back as its own Blocked error and is not retried, because the session itself is flagged.
  • Errors are typed. NotFound, NoData (nothing published yet) and Blocked are different situations and are never collapsed into one.
  • NSE changed the bhavcopy file format on 8 July 2024. The library picks the right format for the date you ask for, so callers don't have to know.
  • unsafe is forbidden across the workspace. Releases ship prebuilt binaries for Linux, macOS and Windows, and sauda has wheels on PyPI for Windows, Linux and Apple Silicon.
  • What it doesn't do is written down too. The pre-open session endpoint isn't implemented, and a few live figures never populate through NSE at all. The docs say so instead of working around it.

Live demo

Upload a recording, watch it move through transcription and summarisation, and reopen the result later. It started as an internship take-home, and the brief asked for visible progress and failure states. Transcripts come from Gnani's batch speech-to-text API and summaries from Groq.

  • The audio goes from the browser straight to S3 on a signed URL, and the API only handles metadata, so no web request ever waits on a provider.
  • Processing is a chain of short steps. Each one re-reads the job from PostgreSQL and schedules the next, so a step that crashes, runs twice or arrives late does no harm.
  • No free hosting tier would run an always-on worker, so in production the queue swaps from Celery and Redis to Cloud Tasks calling a private Cloud Run service. The step logic and the tests are shared between the two.
  • More than 300 tests, plus 23 injected failure scenarios that run end to end through a fault-injecting proxy. Each one ends in a plain error message and, where it makes sense, a retry.
  • The demo is public with no sign-in, so uploads are limited per browser and recordings are deleted from storage after two hours. The transcript and summary stay.

Fork of

OpenTerminal is Andrea Tasselli's dense, keyboard-driven market dashboard (Next.js and Express) that runs on free public data. The project and its US and European coverage are his and his contributors'. My changes tune it for Indian markets:

  • A gRPC provider that pulls NSE data from jugaad-rpc, the server from jugaad-rs: live quotes, history, option chains and expiries for NIFTY, BANKNIFTY and FINNIFTY, index snapshots including India VIX, bulk and block deals, and corporate announcements. If the service is down, every call falls back to Yahoo Finance or TradingView.
  • NSE as the default market across the screener, heatmap, macro, news and portfolio widgets, with US and European markets still a tab away.
  • A TradingView-backed fallback for the SENSEX quote. SENSEX chart history still has no working source, and the README lists that as a known gap instead of hiding it.
  • The option chain also led to a new RPC in jugaad-rs, GetOptionExpiries.

Games and graphics

2D games and simulations in C++, mostly written without an engine.

Project What it is
Just Another Easy Game A 2D platformer in C++17 and raylib: movement and collision, traps, level design, game state and audio. Playable in the browser on itch.io. The online leaderboard runs on Node.js / Express and MongoDB.
ParticleCollision Interactive 2D simulation of charged particles with attraction and repulsion, elastic collisions and a live centre-of-mass readout.
FP-Movement First-person camera and movement controller in raylib.
Just-Another-World-Godot A 2D project in Godot with a web export, made to compare an engine-based workflow with writing the systems by hand.

Tech stack

Area Tools
Languages Rust C++ Python TypeScript JavaScript C Kotlin SQL
Backend Tokio tonic / gRPC FastAPI Node.js Express Celery
Data stores PostgreSQL SQLite MongoDB Redis
Frontend React Next.js Vite Tailwind CSS
Data, ML and LLMs pandas Polars NumPy scikit-learn LightGBM PyTorch FAISS sentence-transformers Anthropic API Groq Ollama
Cloud and tooling Docker Google Cloud Firebase Vercel AWS S3 GitHub Actions Git CMake Cargo Linux
Graphics and games raylib Godot OpenGL SDL2

GitHub activity

GitHub stats Most used languages

Contribution streak

Currently

  • Studying deep learning, with an eye on applying it to time series and documents.
  • Next on Fin_QA: a full re-run of the 850-question benchmark against the final corpus, and re-validating the cross-encoder reranker at full scale.
  • Further out: a 2D RPG.

Contact

The easiest way to reach me is email: amangautam1602@gmail.com

LinkedIn · X · itch.io

Pinned Loading

  1. Fin_QA Fin_QA Public

    Financial Q&A for Indian equities. Deterministic ratio engine + RAG-powered LLM for NSE/BSE companies. CLI, API, dashboard.

    Python 5

  2. jugaad-rs jugaad-rs Public

    Rust toolkit for NSE India market data: live quotes, history, option chains, bhavcopy, indices and corporate filings. Use it as a CLI, a Rust library, a gRPC server (Docker), or from Python with pi…

    Rust 4 1

  3. OpenTerminal OpenTerminal Public

    Forked from ErTasselli/OpenTerminal

    A Terminal-style trading dashboard built entirely on free public market data. No API keys, no subscriptions.

    TypeScript

  4. Just-another-easy-game Just-another-easy-game Public

    A not so simple 2D game built using Raylib

    C++