https://github.com/dragon1086/prism-insight
AI-based stock analysis and trading system
https://github.com/dragon1086/prism-insight
ai llm mcp multi-agent stock
Last synced: 2 months ago
JSON representation
AI-based stock analysis and trading system
- Host: GitHub
- URL: https://github.com/dragon1086/prism-insight
- Owner: dragon1086
- License: agpl-3.0
- Created: 2025-08-15T07:32:09.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2026-05-29T06:06:34.000Z (2 months ago)
- Last Synced: 2026-05-29T06:22:02.856Z (2 months ago)
- Topics: ai, llm, mcp, multi-agent, stock
- Language: Python
- Homepage: https://prism-insight-landing.vercel.app/
- Size: 61.8 MB
- Stars: 611
- Watchers: 14
- Forks: 211
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
- awesome-quant - PRISM-INSIGHT - AI-powered stock analysis system with 13 specialized agents, automated trading via KIS API, supporting Korean & US markets. (Python / Trading & Backtesting)
README
# PRISM-INSIGHT
[](https://github.com/sponsors/dragon1086)
[](https://github.com/dragon1086/prism-insight/stargazers)
> **AI-Powered Stock Market Analysis & Trading System**
>
> 13+ specialized AI agents collaborate to detect surge stocks, generate analyst-grade reports, and execute trades automatically.
English |
한국어 |
日本語 |
中文 |
Español
---
### Platinum Sponsor
**[AI3](https://www.ai3.kr/) | [WrksAI](https://wrks.ai/en)**
AI3, creator of **WrksAI** - the AI assistant for professionals,
proudly sponsors **PRISM-INSIGHT** - the AI assistant for investors.
---
## NEW: ChatGPT Plus/Pro Subscription Support
**No API key? No problem.** PRISM-INSIGHT now supports running analysis directly through your ChatGPT Plus ($20/mo) or Pro ($200/mo) subscription via the **Codex OAuth Proxy**.
```bash
# One-time login (browser will open for ChatGPT auth)
python -m cores.chatgpt_proxy.oauth_login
# Re-authenticate (switch account, or refresh expired tokens)
python -m cores.chatgpt_proxy.oauth_login --force
# Run with your ChatGPT subscription
PRISM_OPENAI_AUTH_MODE=chatgpt_oauth python stock_analysis_orchestrator.py --mode morning
```
> Tokens auto-refresh in the background, so you only need to log in again if you change ChatGPT accounts or your password.
Zero API bills. Same powerful analysis. Your existing subscription does the work.
---
## Mobile App
**Get AI stock analysis on the go**
- **Smart Filtering** — Receive only the Telegram alerts you care about
- **PDF Reports** — Mobile-optimized AI analysis reports
- **Launch Promo (until Apr 23, 2026)** — Install now and get **20 free credits** (normally 10)
---
## Watch PRISM-INSIGHT in Action
[](https://www.youtube.com/watch?v=zAywb1G0wRA)
---
## Try It Now (No Installation Required)
### 1. Live Dashboard
See AI trading performance in real-time:
**[analysis.stocksimulation.kr](https://analysis.stocksimulation.kr/)**
### 2. Telegram Channels
Get daily surge stock alerts and AI analysis reports:
- **[English Channel](https://t.me/prism_insight_global_en)**
- **[Korean Channel](https://t.me/stock_ai_agent)**
- **[Japanese Channel](https://t.me/prism_insight_ja)**
- **[Chinese Channel](https://t.me/prism_insight_zh)**
- **[Spanish Channel](https://t.me/prism_insight_es)**
### 3. Sample Report
Watch an AI-generated Apple Inc. analysis report:
[](https://youtu.be/LVOAdVCh1QE)
---
## Try in 60 Seconds (US Stocks)
The fastest way to try PRISM-INSIGHT. Only requires an **OpenAI API key**.
```bash
# Clone and run the quickstart script
git clone https://github.com/dragon1086/prism-insight.git
cd prism-insight
./quickstart.sh YOUR_OPENAI_API_KEY
```
This generates an AI analysis report for Apple (AAPL). Try other stocks:
```bash
python3 demo.py MSFT # Microsoft
python3 demo.py NVDA # NVIDIA
python3 demo.py TSLA --language ko # Tesla (Korean report)
```
> **Get your OpenAI API key** from [OpenAI Platform](https://platform.openai.com/api-keys)
>
> **Optional**: Add a [Perplexity API key](https://www.perplexity.ai/) to `mcp_agent.config.yaml` for news analysis
>
> **Optional**: Add `ADANOS_API_KEY` to enrich US stock news analysis with structured social sentiment context
Your AI-generated PDF reports will be saved in `prism-us/pdf_reports/`.
Or use Docker (no Python setup needed)
```bash
# 1. Set your OpenAI API key
export OPENAI_API_KEY=sk-your-key-here
# 2. Build and start the local quickstart image
docker compose -f docker-compose.quickstart.yml up --build -d
# 3. Run analysis
docker exec -it prism-quickstart python3 demo.py NVDA
```
The first run builds the image locally, so it may take several minutes.
Reports will be saved to `./quickstart-output/`.
---
## Full Installation
### Prerequisites
- Python 3.10+ or Docker
- OpenAI API Key ([get one here](https://platform.openai.com/api-keys)) or ChatGPT Plus/Pro subscription
### Option A: Python Installation
```bash
# 1. Clone & Install
git clone https://github.com/dragon1086/prism-insight.git
cd prism-insight
pip install -r requirements.txt
# 2. Install Playwright for PDF generation
python3 -m playwright install chromium
# 3. Install perplexity-ask MCP server
cd perplexity-ask && npm install && npm run build && cd ..
# 4. Setup config
cp mcp_agent.config.yaml.example mcp_agent.config.yaml
cp mcp_agent.secrets.yaml.example mcp_agent.secrets.yaml
# Edit mcp_agent.secrets.yaml with your OpenAI API key
# Edit mcp_agent.config.yaml with KRX credentials (Kakao account)
# 5. Run analysis (no Telegram required!)
python stock_analysis_orchestrator.py --mode morning --no-telegram
```
### Option B: Docker (Recommended for Production)
```bash
# 1. Clone & Configure
git clone https://github.com/dragon1086/prism-insight.git
cd prism-insight
cp mcp_agent.config.yaml.example mcp_agent.config.yaml
cp mcp_agent.secrets.yaml.example mcp_agent.secrets.yaml
# Edit config files with your API keys
# 2. Build & Run
docker compose up -d
# 3. Run analysis manually (optional)
docker exec prism-insight-container python3 stock_analysis_orchestrator.py --mode morning --no-telegram
```
**Full Setup Guide**: [docs/SETUP.md](docs/SETUP.md)
---
## What is PRISM-INSIGHT?
PRISM-INSIGHT is a **completely open-source, free** AI-powered stock analysis system for **Korean (KOSPI/KOSDAQ)** and **US (NYSE/NASDAQ)** markets.
### Core Capabilities
- **Surge Stock Detection** — Automatic detection of stocks with unusual volume/price movements
- **AI Analysis Reports** — Professional analyst-grade reports generated by 13 specialized AI agents
- **Trading Simulation** — AI-driven buy/sell decisions with portfolio management
- **Automated Trading** — Real execution via Korea Investment & Securities API
- **Telegram Integration** — Real-time alerts and multi-language broadcasting
- **Macro Intelligence** — Market regime detection, sector rotation analysis, risk event monitoring
### AI Models
- **Analysis & Trading**: OpenAI GPT-5 / GPT-5.4-mini (via API or ChatGPT Plus subscription)
- **Report Generation**: Anthropic Claude Sonnet 4.6
- **Translation**: OpenAI GPT-5 (EN, JA, ZH, ES support)
---
## AI Agent System
13+ specialized agents collaborate in teams:
| Team | Agents | Purpose |
|------|--------|---------|
| **Macro** | 1 agent | Market regime, sector rotation, risk events |
| **Analysis** | 6 agents | Technical, Financial, Industry, News, Market analysis |
| **Strategy** | 1 agent | Investment strategy synthesis |
| **Communication** | 3 agents | Summary, Quality evaluation, Translation |
| **Trading** | 3 agents | Buy/Sell decisions, Journal |
| **Consultation** | 2 agents | User interaction via Telegram |
View Agent Workflow Diagram
**Detailed Agent Documentation**: [docs/CLAUDE_AGENTS.md](docs/CLAUDE_AGENTS.md)
---
## Key Features
| Feature | Description |
|---------|-------------|
| **AI Analysis** | Expert-level stock analysis through GPT-5 multi-agent system |
| **Surge Detection** | Automatic watchlist via morning/afternoon market trend analysis |
| **Telegram** | Real-time analysis distribution to channels |
| **Trading Sim** | AI-driven investment strategy simulation |
| **Auto Trading** | Execution via Korea Investment & Securities API |
| **Dashboard** | Transparent portfolio, trades, and performance tracking |
| **Self-Improving** | Trading journal feedback loop — past trigger win rates automatically inform future buy decisions ([details](docs/TRADING_JOURNAL.md#performance-tracker-피드백-루프-self-improving-trading)) |
| **US Markets** | Full support for NYSE/NASDAQ analysis |
| **Macro Intelligence** | Market regime detection and sector rotation for smarter stock selection |
| **Mobile App** | iOS & Android app with smart filtering and PDF reports |
View Dashboard Screenshots
---
## Trading Performance
### KR Market — Season 2
| Metric | Value |
|--------|-------|
| Period | 2025.09.30 ~ 2026.03.24 |
| Total Trades | 86 |
| Win Rate | 45.35% |
| Avg Return per Trade | +2.84% |
| **Cumulative Return** | **+244.63%** |
| Current Holdings | 5 stocks |
### US Market (Beta)
| Metric | Value |
|--------|-------|
| Period | 2026.01.28 ~ 2026.03.21 |
| Total Trades | 13 |
| Current Holdings | 6 stocks |
**[Live Dashboard](https://analysis.stocksimulation.kr/)**
---
## US Stock Market Module
Same AI-powered workflow for US markets:
```bash
# Run US analysis
python prism-us/us_stock_analysis_orchestrator.py --mode morning --no-telegram
# With English reports
python prism-us/us_stock_analysis_orchestrator.py --mode morning --language en
```
**Data Sources**: yahoo-finance-mcp, sec-edgar-mcp (SEC filings, insider trading)
---
## Documentation
| Document | Description |
|----------|-------------|
| [docs/SETUP.md](docs/SETUP.md) | Complete installation guide |
| [docs/CLAUDE_AGENTS.md](docs/CLAUDE_AGENTS.md) | AI agent system details |
| [docs/TRIGGER_BATCH_ALGORITHMS.md](docs/TRIGGER_BATCH_ALGORITHMS.md) | Surge detection algorithms |
| [docs/TRADING_JOURNAL.md](docs/TRADING_JOURNAL.md) | Trading memory system |
---
## Frontend Examples
### Dashboard
Real-time portfolio tracking and performance dashboard.
**[Live Demo](https://analysis.stocksimulation.kr/)**
```bash
cd examples/dashboard
npm install
npm run dev
# Visit http://localhost:3000
```
**Features**: Portfolio overview, trading history, performance metrics, market selector (KR/US), return comparison vs KOSPI/KOSDAQ
**Dashboard Setup Guide**: [examples/dashboard/DASHBOARD_README.md](examples/dashboard/DASHBOARD_README.md)
---
## MCP Servers
### Korean Market
- **[kospi_kosdaq](https://github.com/dragon1086/kospi-kosdaq-stock-server)** — KRX stock data
- **[firecrawl](https://github.com/mendableai/firecrawl-mcp-server)** — Web crawling
- **[perplexity](https://github.com/perplexityai/modelcontextprotocol)** — Web search
- **[sqlite](https://github.com/modelcontextprotocol/servers-archived)** — Trading simulation DB
### US Market
- **[yahoo-finance-mcp](https://pypi.org/project/yahoo-finance-mcp/)** — OHLCV, financials
- **[sec-edgar-mcp](https://pypi.org/project/sec-edgar-mcp/)** — SEC filings, insider trading
---
## Contributing
1. Fork the project
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Create a Pull Request
---
## License
**Dual Licensed:**
### For Individual & Open-Source Use
[](https://www.gnu.org/licenses/agpl-3.0)
Free under AGPL-3.0 for personal use, non-commercial projects, and open-source development.
### For Commercial SaaS Use
Separate commercial license required for SaaS companies.
**Contact**: dragon1086@naver.com
**Details**: [LICENSE-COMMERCIAL.md](LICENSE-COMMERCIAL.md)
---
## Disclaimer
Analysis information is for reference only, not investment advice. All investment decisions and resulting profits/losses are the investor's responsibility.
---
## Sponsorship
### Support the Project
Monthly operating costs (~$310/month):
- OpenAI API: ~$235/month
- Anthropic API: ~$11/month
- Firecrawl + Perplexity: ~$35/month
- Server infrastructure: ~$30/month
Currently serving 450+ users for free.
---
## Project Growth
[](https://star-history.com/#dragon1086/prism-insight&Date)
---
**If this project helped you, please give us a Star!**
**Contact**: [GitHub Issues](https://github.com/dragon1086/prism-insight/issues) | [Telegram](https://t.me/stock_ai_agent) | [Discussions](https://github.com/dragon1086/prism-insight/discussions)