Gemini Quant is a financial analysis tool designed to transform Gemini CLI into a research analyst.
You can use it free with Gemini CLI! No API keys, no token payments, no subscriptions.
The core of this repository is the AI Investor engine—a research framework that directs Gemini to perform multi-layered market analysis. Unlike simple summarizers, this system executes a rigorous due diligence process.
First, you need to install the official Gemini CLI. Follow the instructions in the official Gemini CLI repository.
git clone https://github.com/lopushok9/gemini_quant.git
cd gemini_quantNavigate to the ai-investor folder and install it as a Gemini extension:
cd ai-investor
gemini extension install .Verify the installation:
gemini extension listYou should see ai-investor in the list of installed extensions.
Once installed, you can use these commands directly in your terminal, it may take a while to load up to 3 minutes (run commands from the ai-investor folder):
| Command | Description | Example |
|---|---|---|
gemini analyze [TICKER] |
Long-term investment analysis. Generates a full research report with BUY/SELL/HOLD rating, price targets, risk assessment. | gemini analyze AAPL |
gemini analyze-st [TICKER] |
Short-term trading analysis. Focuses on technical indicators, momentum, and near-term catalysts for swing trading. | gemini analyze-st TSLA |
gemini analyze-lev [TICKER] |
Leveraged trading analysis. Evaluates assets for short-term leveraged positions with specific entry/exit points. | gemini analyze-lev BTC |
gemini poly-s |
Polymarket Scanner. Scans the top Finance & Economy markets for high-potential trading opportunities. | gemini poly-s |
gemini poly [TOPIC] |
Polymarket Analysis. Deep dive into a specific prediction market to find +EV opportunities. | gemini poly "Bitcoin price" |
The agent follows a strict 3-pillar investigative strategy:
-
Financial Performance
- Deep dive into revenue growth, margins, and key business KPIs.
- Analysis of earnings reports and analyst coverage.
-
Market Positioning
- Peer comparison with valuation multiples (P/E, P/S).
- Sector performance and competitive analysis.
-
Advanced Intelligence
- Technical Context: Support/resistance levels, volume patterns.
- Options Flow: Put/call ratios, implied volatility trends.
- Insider Signals: Tracking executive buying/selling and institutional ownership.
- Institutional-Grade Reports: Generates reports with specific "BUY/SELL/HOLD" ratings, price targets (with upside/downside %), and conviction levels.
- Risk Assessment: Detailed breakdown of company, macro, and ESG risks, including specific position sizing recommendations.
- Catalyst Tracking: Identifies near-term (earnings), medium-term (strategic), and event-driven (M&A) catalysts.
The agent now includes specialized tools for analyzing prediction markets:
- Market Scanner (
poly-s): Identifies high-value opportunities by analyzing market discrepancies and "overextended" odds in Finance & Economy sectors. - Deep Analysis (
poly): Conducts a rigorous EV (Expected Value) analysis on specific markets, comparing implied probabilities with real-world data and sentiment.
Included in this suite are tools for monitoring and analyzing Hyperliquid markets.
A Terminal User Interface (TUI) for monitoring assets on Hyperliquid. It provides a distraction-free, keyboard-driven environment for execution.
cd hyperliquid-terminal
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python3 main.pys- Switch Assett- Change Timeframeq- Quit
This script provides a of Hyperliquid positions, focusing on large positions (≥ $100k) that are approaching liquidation.
- Position:Large and medium-sized positions with varying leverage and proximity to liquidation based on current market conditions.
- Market Summary: Provides an overview of market risk, including total critical positions and value at risk.
- Configurable Assets: Monitor key assets like BTC, ETH, SOL.
cd hyperliquid-terminal
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python3 liquid.py [ASSET]Example: To monitor simulated positions for BTC:
python3 liquid.py BTCTo monitor all configured assets:
python3 liquid.pyThis script monitors Hyperliquid in real-time for executed large trades on specified assets. Using a WebSocket connection, it provides immediate alerts for trades exceeding a configurable notional value (default: $100,000 USD).
- Real-time Monitoring: Connects via WebSocket to receive live trade data.
- Configurable Threshold: Easily set the minimum notional value for trades to be alerted.
- Asset Filtering: Monitor all configured assets or focus on a specific one via command-line.
- Concise Output: Displays essential trade details (time, asset, side, price, size, notional value).
cd hyperliquid-terminal
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python3 large_trades.py [ASSET]Example: To monitor large trades for ETH:
python3 large_trades.py ETHTo monitor all configured assets:
python3 large_trades.pyMonitor large trades and market activity on Polymarket prediction markets in real-time.
A real-time monitoring system powered by WebSockets that tracks large "whale" trades and volume spikes.
- Real-time WebSocket Feed: Instant alerts for executed trades directly from Polymarket's data stream.
- Whale Tracking: Automatically filters for significant BUY-side entries (default >$1,000).
- Smart Filter: Focuses on high-conviction trades within the 10%-90% price range, filtering out noise.
- Volume Spike Alerts: Background monitoring for sudden jumps in market volume.
cd Poly
npm install
npm run devReal-time monitoring of SEC Form 4 filings to track executive buying and selling activity.
- Live Tracking: Fetches the latest filings directly from the SEC EDGAR RSS feed.
- Advanced Filtering: Filter by ticker (
--ticker), limit results, or focus only on open market buys/sells. - Full Transparency: Extracts exact trade dates, prices, shares, and total transaction values.
cd insider
pip install requests feedparser lxml tabulate
python3 insider.py
--ticker AAPL / choose ticker
--only-buysell / only buys or sells
--limit 60 / limit resultsDisclaimer: This project is for educational purposes only. Always do your own research (DYOR). Trading and investing involve significant risk.