Skip to main content

Stock Analysis Agent

Project description

🚀 rallies-cli

AI-Powered investment research

ChatGPT for traders, backed by real-time financial data

Python License: GPL v3 Rallies.ai

Rallies CLI Demo

✨ What is rallies-cli?

Rallies CLI is an intelligent investment research agent built by Rallies that combines the conversational power of AI with real-time financial data. Think of it as ChatGPT specifically designed for traders and investors, equipped with live market data, news feeds, and comprehensive financial analysis capabilities.

What's different from ChatGPT, Perplexity Finance, etc?

Most existing LLMs, even with web search and other capabilities rely on out-dated stock market data. Moreover, since they are not backed by real-time data, running complex queries is hard, and often returns inaccurate results e.g try asking an LLM "can you summarize today's options flow data for AAPL", and you'll realize that a lot of the answers simply rely on web searches which are never real-time.

On the contrary, rallies-cli relies on real-time data that is updated as frequently as possible.

🚀 Quick Start

Installation

# Install from source
git clone https://github.com/your-username/rallies-cli.git
cd rallies-cli
pip install -e .


# Install from PyPI (coming soon)
pip install rallies

Setup

  1. Get your OpenAI API key from OpenAI Platform
  2. Set environment variable:
    export OPENAI_API_KEY="sk-your-api-key-here"
    
  3. Launch rallies from your terminal:
    rallies
    

That's it! You're ready to start researching.

💡 Usage Examples

Basic Queries

> What's happening with AAPL today?
> Analyze Tesla's recent performance
> Show me top gainers in tech sector

Advanced Analysis

> Compare MSFT vs GOOGL over the last quarter
> Find stocks with cup and handle patterns
> What's the market sentiment on cryptocurrency?

Technical Analysis

> Show me NVDA's technical indicators
> Find oversold stocks in the S&P 500
> Analyze Bitcoin's recent price action

News & Events

> Latest earnings reports this week
> Federal Reserve meeting impact on markets
> Breaking news affecting my portfolio

🛠️ CLI Commands

Command Description
/help Show available commands and usage
/key API_KEY Set your rallies.ai API key for more usage
/feed Browse recent high-scoring community questions
/clear Clear conversation history
/compact Compress conversation while preserving context
/exit or /quit Exit the application

🔑 API Keys & Authentication

OpenAI API Key (Required)

export OPENAI_API_KEY="sk-your-openai-key"

Rallies.ai API Key (Optional - Higher usage limits)

# Set via CLI
rallies
> /key your-rallies-api-key

The Rallies.ai API key provides you higher rate limits. You can get your key by registering for a free account at Rallies

📋 Requirements

  • Python 3.8+
  • OpenAI API Key (required)
  • Terminal with color support (recommended)
  • Internet connection for real-time data

Dependencies

  • openai - GPT-4 integration
  • rich - Terminal formatting and colors
  • requests - HTTP requests for data APIs
  • inquirer - Interactive prompts
  • tiktoken - Token counting and management
  • numpy - Numerical computations

🐛 Troubleshooting

Common Issues

"OpenAI API Key not found"

export OPENAI_API_KEY="sk-your-key-here"

"Rate limit exceeded"

  • Get a Rallies.ai API key for higher limits
  • Use /compact to reduce token usage

"Network connection error"

  • Check internet connection
  • Verify firewall settings
  • Try again after a few moments

"Import errors"

pip install --upgrade rallies

Getting Help

🌐 Links

⚠️ Disclaimer

This tool is for educational and research purposes only. Rallies CLI does not provide investment advice, recommendations, or financial guidance. All information provided is for informational purposes only and should not be considered as investment advice. Always consult with a qualified financial advisor before making any investment decisions. Past performance does not guarantee future results. Trading and investing involve risk of loss.

📄 License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.


Built with ❤️ by the Rallies team - Making financial research accessible to everyone

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rallies-0.1.0.tar.gz (28.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

rallies-0.1.0-py3-none-any.whl (27.7 kB view details)

Uploaded Python 3

File details

Details for the file rallies-0.1.0.tar.gz.

File metadata

  • Download URL: rallies-0.1.0.tar.gz
  • Upload date:
  • Size: 28.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for rallies-0.1.0.tar.gz
Algorithm Hash digest
SHA256 5fbf2044e5d7262948fd57eb923f27061a1bf83cb432241f42a2eca85d9b828b
MD5 f992ecc347ed138aa76f6f89d6a6252e
BLAKE2b-256 013bc5e8fdcdb9380e5369057ca9ed01cf1ae713e4a5d8913f54dc3b72cee5a8

See more details on using hashes here.

File details

Details for the file rallies-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: rallies-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 27.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for rallies-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 62cf59d101a7075de382b65588f6347cc217cffeac30f06504e34b81b6146232
MD5 c91f09e28b7dd26193caeabe80ac2ed6
BLAKE2b-256 245457ba524c54c6f3dea83e090cefa6a1dfde9177aa3d62c7032f184afd21b8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page