Skip to content

Prasanna1717/ProjectORQON

Repository files navigation

ProjectORQON πŸš€

License: MIT Vercel IBM WatsonX

🎯 Overview

ProjectORQON is an enterprise-grade AI-powered compliance and trading platform that leverages IBM WatsonX AI to provide intelligent financial analysis, automated compliance monitoring, and real-time trade analytics. Built with a modern tech stack combining React, Python, and cutting-edge AI capabilities.

🌐 Live Demo: https://frontend-35aeyyy00-prasanna1717s-projects.vercel.app


✨ Key Features

πŸ€– AI-Powered Intelligence

  • WatsonX Integration: Advanced AI models for financial analysis and compliance
  • RAG System: Retrieval-Augmented Generation for context-aware responses
  • Multi-Modal AI: Support for text, voice, and document analysis

πŸ“Š Compliance & Analytics

  • Real-time compliance monitoring and alerting
  • Automated trade validation and risk assessment
  • Executive dashboards with interactive charts
  • Audit logging and reporting

πŸ’Ό Trading & Portfolio Management

  • Trade blotter with real-time updates
  • Portfolio performance tracking
  • Market data integration (Finnhub API)
  • Email-based trade parsing and automation

πŸ”— Integrations

  • Google Workspace: Gmail integration for trade notifications
  • IBM WatsonX AI: Enterprise AI capabilities
  • Astra DB: Vector database for RAG
  • ChromaDB: Local vector storage for compliance memory
  • Model Context Protocol (MCP): Extensible tool system

πŸ› οΈ Tech Stack

Frontend

  • React 18 with Vite
  • IBM Carbon Design System - Enterprise UI components
  • Carbon Charts - Data visualization
  • TailwindCSS - Utility-first styling
  • Axios - API communication
  • Zustand - State management

Backend

  • Python 3.13
  • FastMCP - Model Context Protocol server
  • IBM WatsonX AI SDK - AI/ML capabilities
  • LangChain - AI orchestration
  • ChromaDB - Vector database
  • Google APIs - Gmail, Docs, Sheets integration
  • Finnhub API - Market data

Infrastructure

  • Vercel - Frontend hosting
  • Git - Version control
  • Docker - Containerization (optional)

πŸ“ Project Structure

ProjectORQON/
β”œβ”€β”€ orqon_core/                    # Main application directory
β”‚   β”œβ”€β”€ frontend_pro/              # React frontend (Vite + Carbon)
β”‚   β”‚   β”œβ”€β”€ src/
β”‚   β”‚   β”‚   β”œβ”€β”€ components/        # React components
β”‚   β”‚   β”‚   β”œβ”€β”€ lib/               # Utilities
β”‚   β”‚   β”‚   └── App.jsx            # Main app component
β”‚   β”‚   β”œβ”€β”€ package.json
β”‚   β”‚   └── vite.config.js
β”‚   β”œβ”€β”€ tools/                     # MCP tools and integrations
β”‚   β”‚   β”œβ”€β”€ ibm_adk_tools/        # IBM Agent Development Kit tools
β”‚   β”‚   β”œβ”€β”€ google_workspace_tools.py
β”‚   β”‚   β”œβ”€β”€ finnhub_tools.py
β”‚   β”‚   └── rag_tools.py
β”‚   β”œβ”€β”€ data/                      # Data storage
β”‚   β”‚   β”œβ”€β”€ trade_blotter.csv
β”‚   β”‚   └── compliance_memory/
β”‚   β”œβ”€β”€ main.py                    # Main application entry
β”‚   β”œβ”€β”€ mcp_server.py              # MCP server implementation
β”‚   β”œβ”€β”€ watsonx_llm.py            # WatsonX integration
β”‚   └── requirements.txt
β”œβ”€β”€ IBM docs/                      # Documentation and configs
β”œβ”€β”€ TECHNICAL_ARCHITECTURE.md      # System architecture
β”œβ”€β”€ COMPLIANCE_PLATFORM_README.md  # Compliance details
└── README.md                      # This file

πŸš€ Quick Start

Prerequisites

  • Node.js 18+ and npm
  • Python 3.13+
  • Git
  • IBM WatsonX API credentials
  • Google Cloud credentials (for Gmail integration)
  • Finnhub API key (optional, for market data)

Frontend Setup

# Navigate to frontend directory
cd orqon_core/frontend_pro

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

The frontend will be available at http://localhost:3000

Backend Setup

# Navigate to orqon_core directory
cd orqon_core

# Create virtual environment
python -m venv orqon_env

# Activate virtual environment
# Windows:
.\orqon_env\Scripts\activate
# Linux/Mac:
source orqon_env/bin/activate

# Install dependencies
pip install -r requirements.txt

# Create .env file with your credentials
cat > .env << EOL
WATSONX_API_KEY=your_watsonx_api_key
WATSONX_PROJECT_ID=your_project_id
FINNHUB_API_KEY=your_finnhub_key
ASTRA_DB_APPLICATION_TOKEN=your_astra_token
ASTRA_DB_API_ENDPOINT=your_astra_endpoint
EOL

# Run the MCP server
python mcp_server.py

# Or run the main application
python main.py

πŸ”§ Configuration

Environment Variables

Create a .env file in the orqon_core/ directory:

# IBM WatsonX
WATSONX_API_KEY=your_watsonx_api_key_here
WATSONX_PROJECT_ID=your_project_id_here
WATSONX_URL=https://us-south.ml.cloud.ibm.com

# Astra DB (Vector Database)
ASTRA_DB_APPLICATION_TOKEN=your_token_here
ASTRA_DB_API_ENDPOINT=your_endpoint_here

# Finnhub (Market Data)
FINNHUB_API_KEY=your_finnhub_key_here

# Google Workspace (Optional)
GOOGLE_CREDENTIALS_PATH=./data/google_credentials.json

Google Workspace Setup

  1. Create a Google Cloud project
  2. Enable Gmail API and Google Workspace APIs
  3. Create OAuth 2.0 credentials
  4. Download credentials as google_credentials.json
  5. Place in orqon_core/data/ directory

πŸ“Š Features Overview

Dashboard

  • Executive summary with KPIs
  • Real-time market overview
  • Portfolio performance metrics
  • Compliance status indicators

Trade Management

  • Trade blotter with filtering and search
  • Email parsing for automated trade entry
  • Trade validation and compliance checks
  • Historical trade analysis

Compliance Monitoring

  • Real-time compliance rule engine
  • Automated alert generation
  • Audit trail and logging
  • Compliance reports and analytics

AI Chat Interface

  • WatsonX-powered conversational AI
  • Context-aware responses using RAG
  • Multi-modal input (text, voice, documents)
  • Integration with all platform features

πŸ”’ Security

  • API keys and credentials stored in .env (not committed to Git)
  • OAuth 2.0 for Google Workspace integration
  • Secure credential management with Python-dotenv
  • Input validation and sanitization
  • Audit logging for compliance

πŸ“ˆ Performance

  • Frontend: Optimized Vite build with code splitting
  • Backend: Async operations with FastMCP
  • Database: Vector search with ChromaDB and Astra DB
  • Caching: Smart caching for API responses
  • CDN: Vercel Edge Network for global distribution

πŸ“ License

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


πŸ™ Acknowledgments

  • IBM WatsonX - For providing enterprise AI capabilities
  • Carbon Design System - For the beautiful UI components
  • Vercel - For seamless deployment and hosting
  • FastMCP - For the Model Context Protocol implementation

πŸ“§ Contact

Project Maintainer: @Prasanna1717

Repository: https://github.com/Prasanna1717/ProjectORQON


πŸ—ΊοΈ Roadmap

  • Add more compliance rules and regulations
  • Enhanced ML models for trade prediction
  • Mobile app support
  • Advanced reporting features
  • Multi-language support
  • Real-time collaboration features

Built with ❀️ using IBM WatsonX AI

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors