Files
All-in-one-Financial-Analysis/atlas-terminal/README.md
T
shawnkim1997andClaude Opus 4.6 b2acda81ee feat: add Atlas Terminal — Next.js 14 + FastAPI full-stack migration
Complete migration from Streamlit to Next.js 14 App Router + FastAPI backend.

Frontend (Next.js 14):
- 10 pages: Overview, Research, Valuation, Technical, Markets, Earnings, News, Portfolio, Filings, Settings
- Terminal Noir dark theme with custom Tailwind config
- TradingView Lightweight Charts for candlestick/volume
- Valuation: DCF, Sensitivity Matrix, Monte Carlo, Tornado, Reverse DCF
- Financial Statements table with YoY growth badges and margin rows
- SEC EDGAR inline filing viewer with section tabs
- News split-view with iframe article embedding
- Technical Analysis with RSI, MACD, Bollinger, Fibonacci, Moving Averages
- Earnings beat/miss visualization
- AI Copilot chat panel with Gemini integration

Backend (FastAPI):
- 13 routers: market_data, financials, valuation, technical, earnings, insider, edgar, news, portfolio, analysis, chat, estimates, fx
- Services: DCF engine, Monte Carlo simulation, sensitivity analysis, risk metrics, SEC parser, technical indicators
- yfinance + yahooquery data sources with fallback pattern
- SQLite caching layer

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-21 02:10:10 +00:00

74 lines
2.4 KiB
Markdown

# ATLAS Terminal
> Personal Bloomberg-style financial terminal -- real-time market data,
> AI-powered analysis, DCF valuation, and portfolio management.
## Features
- **SEC EDGAR** -- 10-K filing download and section extraction
- **AI Analysis** -- Gemini-powered financial statement analysis
- **DCF Valuation** -- Single-stage, two-stage, and Excel-style DCF models with Damodaran WACC
- **Market Data** -- Live stock quotes, indices, and sector data
- **News** -- Financial news aggregation via RSS feeds
- **Crypto** -- Top 20 cryptocurrency prices (Bithumb KRW + Binance USD)
- **FX** -- Foreign exchange rates and 1-year history via yfinance
- **Portfolio** -- Position tracking with P&L and multi-currency support
- **Financial Health** -- DuPont analysis, Altman Z-Score, Piotroski F-Score, radar charts
## Tech Stack
**Backend:** Python 3.12+, FastAPI, Pydantic v2, yfinance, yahooquery, Google Generative AI, Supabase
**Frontend:** Next.js 14, TypeScript, Tailwind CSS
## Quick Start
```bash
# Backend
cd atlas-terminal
pip install -r requirements.txt
cp .env.example .env # configure API keys
uvicorn server.main:app --reload --port 8000
# Frontend
cd apps/web
npm install
npm run dev
```
The API will be available at `http://localhost:8000` and the web UI at `http://localhost:3000`.
## Project Structure
```
atlas-terminal/
server/
main.py # FastAPI entry point
models/ # Pydantic schemas, Supabase client
routers/ # API route handlers
services/ # Business logic, data fetchers
utils/ # safe_float, ticker utilities
apps/web/ # Next.js frontend
supabase/migrations/ # Database schema
tests/ # pytest test suite
scripts/ # Automation scripts
```
## API Endpoints
| Prefix | Description |
|------------------|------------------------------------|
| `/api/edgar` | SEC EDGAR 10-K filings |
| `/api/analysis` | AI-powered financial analysis |
| `/api/valuation` | DCF valuation and smart defaults |
| `/api/market` | Stock quotes and market overview |
| `/api/news` | Financial news feeds |
| `/api/crypto` | Cryptocurrency prices |
| `/api/fx` | Foreign exchange rates and history |
| `/api/portfolio` | Portfolio position management |
| `/health` | Liveness probe |
## License
Private project.