Skip to content

Trading-Goose/Trading-Goose.github.io

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

TradingGoose Logo TradingGoose

Discord

An intelligent trading platform powered by multiple AI agents that collaborate to analyze markets, manage portfolios, and execute trades with sophisticated risk management.

Open Source Version Available - Deploy your own instance!

๐Ÿ“– Overview

TradingGoose focuses on event-driven trading strategy and analysis that harnesses the power of AI agents and Alpaca's market data to deliver sophisticated trading recommendations and automated portfolio management insights. The system employs a multi-agent workflow architecture where specialized AI agents collaborate to analyze market-moving events in real-time.

๐ŸŽฏ Core Concept

The system leverages Large Language Models' natural language processing capabilities to rapidly analyze news, social media, and other textual data sources that often trigger market volatility. By processing these events faster than traditional methods, TradingGoose identifies potential market movements and generates timely trading signals for user-selected stocks.

๐Ÿ”„ Intelligent Execution

Once analysis agents provide their recommendations, the Portfolio Manager AI agent takes over to:

  • Analyze the user's Alpaca account details and current portfolio state
  • Consider user-configured position sizing, allocation strategies, and risk tolerance
  • Generate final trading orders with precise values and actions for specific tickers
  • Make autonomous decisions that may differ from initial recommendations based on actual portfolio constraints and risk management

This two-layer approach ensures that while the analysis agents focus on identifying opportunities, the portfolio manager maintains discipline in execution, potentially overriding recommendations when they conflict with portfolio health, risk limits, or allocation rules.

๐Ÿ—๏ธ Architecture Foundation

This project's multi-agent analysis workflow architecture is based on the TauricResearch/TradingAgents framework, which pioneered the concept of collaborative AI agents for financial analysis.

โœจ Features

๐Ÿค– Multi-Agent Architecture

  • Coordinator Agent: Orchestrates analysis workflows and manages agent collaboration
  • Market Analyst: Analyzes market trends and technical indicators
  • Fundamentals Analyst: Evaluates company financials and valuation metrics
  • News Analyst: Processes and interprets market news and events
  • Social Media Analyst: Monitors social sentiment and trending topics
  • Risk Analysts (Safe/Neutral/Risky): Provides multi-perspective risk assessments
  • Portfolio Manager: Optimizes portfolio allocation and rebalancing

๐Ÿ“Š Core Capabilities

  • Real-time Market Analysis: Continuous monitoring of stocks and market conditions
  • Multi-Stock Analysis: Analyze multiple stocks simultaneously in a single workflow
  • Portfolio Management: Comprehensive portfolio optimization with position sizing and allocation strategies
  • Scheduled Rebalancing: Automated portfolio rebalancing on daily, weekly, or monthly schedules
  • Live Trade Execution: Real order execution through Alpaca Markets (paper and live trading)
  • Risk Assessment: Multi-dimensional risk analysis from conservative to aggressive perspectives
  • Workflow Visualization: Real-time tracking of analysis and decision-making processes
  • Historical Tracking: Complete audit trail of analyses, trades, and rebalancing activities

๐Ÿ” Security & Access Control

  • Role-Based Access Control (RBAC): Granular permission system with admin, moderator, and user roles
  • Secure Authentication: Supabase-powered authentication with email verification
  • Invitation System: Controlled user onboarding through admin-managed invitations
  • API Key Management: Secure storage and management of trading API credentials

๐Ÿ› ๏ธ Tech Stack

๐ŸŽจ Frontend

  • React 18 with TypeScript
  • Vite for fast development and building
  • TailwindCSS for styling
  • Shadcn/ui component library
  • React Router for navigation
  • Recharts for data visualization

โš™๏ธ Backend

  • Supabase for database, authentication, and real-time updates
  • Edge Functions for serverless API endpoints & running workflow in background
  • PostgreSQL for data persistence
  • Row Level Security (RLS) for data isolation

๐Ÿ“ˆ Trading Integration

  • Alpaca Markets API for market data and trade execution
  • Customizable AI Providers for agent intelligence (OpenAI, Anthropic, Google, and more)


๐Ÿ”„ How It Works

๐Ÿ”ฌ The Analysis Process

When you initiate a stock analysis, TradingGoose orchestrates a sophisticated multi-agent workflow:

Analysis Flow
Note: This workflow architecture is adapted from the TauricResearch/TradingAgents framework.
1. ๐Ÿ“Š Data Analysis Phase
  • ๐ŸŒ Macro Analyst: Government data and economic indicators
  • ๐Ÿ“ˆ Market Analyst: Historical data and technical indicators
  • ๐Ÿ“ฐ News Analyst: Latest news and sentiment analysis
  • ๐Ÿ’ฌ Social Media Analyst: Social platform trends and impact
  • ๐Ÿ’ฐ Fundamentals Analyst: Financial statements and profitability
2. ๐Ÿ” Research & Debate Phase
  • ๐Ÿ‚ Bull Researcher agent presents positive evidence and growth potential
  • ๐Ÿป Bear Researcher agent identifies risks and presents cautionary analysis
  • โš–๏ธ Both perspectives are rigorously evaluated for balance
3. โš ๏ธ Risk Assessment Phase
  • Three specialized risk agents analyze from different perspectives:
    • ๐Ÿ›ก๏ธ Safe Agent: Conservative approach focusing on capital preservation
    • โš–๏ธ Neutral Agent: Balanced view weighing opportunities against risks
    • ๐Ÿš€ Risky Agent: Aggressive stance for high-growth potential
4. ๐Ÿงฉ Decision Synthesis
  • ๐Ÿ“‹ Research Manager consolidates all agent insights
  • ๐ŸŽฏ Risk Manager combines analyses with defined risk parameters
  • ๐Ÿ’ผ Portfolio Manager evaluates position sizing and portfolio impact
5. โœ… Execution Ready
  • ๐Ÿ“Š Final recommendations are presented with confidence scores
  • ๐Ÿšฆ Trade signals are generated based on collective intelligence
  • ๐Ÿ“ All analysis is logged for historical tracking

โš–๏ธ The Rebalancing Process

TradingGoose continuously monitors your portfolio and market conditions:

Rebalance Flow
1. ๐Ÿ‘๏ธ Continuous Monitoring
  • ๐Ÿ“‰ Price movements are tracked against user-defined thresholds
  • ๐ŸŽฏ Portfolio allocations are compared to target weights
  • ๐ŸŒ Market conditions are evaluated for rebalancing opportunities
2. ๐ŸŽฏ Opportunity Detection
  • ๐Ÿšจ When thresholds are exceeded, the Opportunity Agent activates
  • ๐Ÿ“ Stocks requiring attention are identified and prioritized
  • ๐Ÿ”Ž Market-wide screening identifies new potential positions
3. ๐ŸŽฒ Strategic Analysis
  • ๐Ÿ”ฌ Selected stocks undergo full multi-agent analysis
  • ๐Ÿ“Š Current positions are evaluated for scaling or exit
  • ๐Ÿ†• New opportunities are assessed for entry
4. ๐ŸŽจ Portfolio Optimization
  • ๐ŸŽฏ Target allocations are calculated based on risk tolerance
  • โš–๏ธ Rebalancing trades are proposed to achieve optimal weights
  • ๐Ÿ’ธ Tax implications and transaction costs are considered
5. ๐Ÿš€ Execution Management
  • ๐Ÿ“‹ Proposed changes are presented for review
  • โœ… Approved rebalancing is executed through connected brokers
  • ๐Ÿ“ˆ Performance tracking begins immediately post-execution


๐Ÿš€ Usage

๐Ÿ” Running an Analysis

  1. Navigate to the Dashboard
  2. Enter a stock ticker in the search bar
  3. Click "Analyze" to trigger the multi-agent workflow
  4. Monitor progress in real-time through the workflow visualization
  5. Review comprehensive insights from all agents

๐Ÿ’ผ Portfolio Rebalancing

  1. Go to Settings > Rebalancing
  2. Configure rebalancing settings (position sizes, thresholds, frequency)
  3. Schedule automatic rebalancing or trigger manually
  4. Review proposed changes before execution
  5. Track rebalancing history and performance

๐ŸŒŸ Key Features in Action

๐Ÿง  Intelligent Analysis

  • Multi-perspective evaluation: Every stock is analyzed from bullish and bearish viewpoints
  • Risk-adjusted recommendations: Three risk profiles ensure suitable strategies for all investors
  • Confidence scoring: Each recommendation includes transparency about certainty levels
  • Historical context: Past performance and patterns inform future predictions

๐Ÿ’Ž Smart Portfolio Management

  • Automated rebalancing: Maintains optimal portfolio allocation without manual intervention
  • Scheduled execution: Set daily, weekly, or monthly rebalancing schedules that run automatically
  • Multi-stock portfolio analysis: Evaluate entire portfolio health and opportunities across all holdings
  • Threshold-based triggers: Customizable sensitivity to market movements
  • Real order execution: Direct integration with Alpaca for live market orders
  • Position sizing algorithms: Smart allocation based on risk, conviction, and portfolio balance
  • Tax-aware decisions: Considers holding periods and tax implications
  • Dynamic position sizing: Adjusts positions based on conviction and risk tolerance

๐Ÿ“ก Real-time Monitoring

  • Live workflow visualization: Watch agents collaborate in real-time
  • Progress tracking: See exactly which phase of analysis is active
  • Performance metrics: Track success rates and portfolio growth
  • Comprehensive audit trail: Every decision is logged and traceable

๐Ÿ”’ Security Considerations

  • All API keys are stored encrypted in environment variables
  • Database access is controlled through Row Level Security
  • User actions are authenticated and authorized through RBAC
  • Sensitive operations require admin privileges
  • All trades can be executed in paper trading mode for testing

๐Ÿ“„ License

This project is licensed under the AGPL-3.0 License - see the LICENSE file for details.

๐Ÿ’ฌ Support

For issues, questions, or suggestions:

๐Ÿšง Development

๐ŸŽ‰ No humans were harmed in the making of this application!

This entire project was crafted with love by Claude Code - every single line of code, from the sleekest UI component to the smartest trading algorithm, was written by AI. Zero human-written code, 100% AI magic! ๐Ÿช„

Who says robots can't be creative? This production-ready financial platform proves that AI can build sophisticated applications that actually work in the real world. Welcome to the future of software development! ๐Ÿš€



โœ… Feature Checklist

Analysis Features

  • Multi-stock concurrent analysis
  • Cancel/delete running analysis
  • Retry failed analysis from specific failed agent
  • Reactivate stale/stuck analysis workflows
  • Real-time workflow visualization with progress tracking
  • Historical analysis tracking and audit trail

Portfolio Management

  • Automated Scheduled rebalancing (daily/weekly/monthly)
  • Manual rebalancing triggers
  • Position size configuration (min/max)
  • Multi-stock portfolio monitoring

Trading Features

  • Paper trading mode for testing
  • Live trading execution via Alpaca
  • Real-time order status tracking
  • Position management and monitoring

AI Configuration

  • Multiple AI provider support (OpenAI, Anthropic/Claude, Google, DeepSeek)
  • Custom max tokens configuration per agent
  • Provider failover and retry logic
  • Model selection flexibility

####Data & Analysis

  • Historical data range selection
  • Custom analysis timeframes
  • Technical indicator calculations
  • Fundamental data integration
  • News sentiment analysis
  • Social media trend tracking

User Management

  • User Acount system
  • API key management interface
  • User activity tracking
  • Secure credential storage

๐Ÿ™ Acknowledgments


Important: Always conduct your own research and consider consulting with a financial advisor before making investment decisions. Past performance does not guarantee future results.

About

Frontend for Trading-Goose. A Multi-Agents LLM Financial Trading Framework for both individual stock analysis & portfolio management

Topics

Resources

License

Stars

Watchers

Forks

Contributors 2

  •  
  •  

Languages