How ayushh404/falcon-hedge-fund works
This is an Indian-stock swing-trade signal generator, not a broker or execution system. The main workflow is a weekly scan: load market data, gate on market regime, rank sectors and stocks, evaluate setups and filters, then produce reviewable candidate cards. A user executes manually and approves taken trades for daily exit monitoring. Macro and announcement screening are additional candidate safeguards. Source excerpts and the index establish the weekly orchestration and selected calls; daily tracking and several optional capabilities are represented from README documentation.
Main entry points: pipeline.py Weekly and daily orchestration · macro.py Macro catalyst tilts · data.py Market data loader · main.py CLI commands
Components 28
Run control
- CLI commands
main.py - Weekly and daily orchestration
pipeline.py - Ranking backtest
backtest.py
Signal pipeline
- Market regime gate
regime.py - Sector ranking
sectors.py - Stock factor ranking
scoring.py - Technical setups
technicals.py - Indicator calculations
indicators.py - Hard candidate filters
filters.py
Review safeguards
- Macro catalyst tilts
macro.py - Exposure map
data/exposure_map.yaml - YAML reader
yaml_lite.py - News event extraction
news.py - Announcement screening
news_filter.py - Chart and news review
ai_review.py - Review gallery
gallery.py
Tracking and alerts
- Sizing and exits
risk.py - Charts and Telegram cards
report.py - Position state
data/state.json - Candidate and watchlist outputs
out
Data and integrations
- Market data loader
data.py - NSE universe lists
nse_lists.py - Demo data
synthetic.py - NSE announcements
nse_announcements.py
Other components
- Operator
- Manual broker action
- Telegram
- Anthropic API
Connections 36
- Operator → CLI commands: runs commands
README.md - CLI commands → Weekly and daily orchestration: dispatches scans
main.py - CLI commands → Ranking backtest: runs backtest
main.py - Weekly and daily orchestration → Market data loader: loads data
pipeline.py - Market data loader → NSE universe lists: refreshes universe
data.py - Market data loader → Demo data: uses for demo
data.py - Market data loader → Operator: fetches market prices
- Weekly and daily orchestration → Market regime gate: checks regime
pipeline.py - Weekly and daily orchestration → Sector ranking: ranks sectors
pipeline.py - Weekly and daily orchestration → Stock factor ranking: scores stocks
pipeline.py - Stock factor ranking → Technical setups: analyzes setups
scoring.py - Technical setups → Indicator calculations: uses indicators
technicals.py - Weekly and daily orchestration → Hard candidate filters: filters candidates
pipeline.py - Weekly and daily orchestration → Sizing and exits: sizes positions
pipeline.py - Weekly and daily orchestration → Macro catalyst tilts: computes macro tilts
pipeline.py - Macro catalyst tilts → Exposure map: loads sensitivities
README.md - Macro catalyst tilts → YAML reader: reads map
macro.py - Macro catalyst tilts → News event extraction: extracts events
macro.py - News event extraction → Anthropic API: labels events
README.md - Macro catalyst tilts → Market data loader: uses market proxies
README.md - Weekly and daily orchestration → Announcement screening: screens survivors
pipeline.py - Announcement screening → NSE announcements: fetches filings
news_filter.py - Announcement screening → Chart and news review: reviews flags
news_filter.py - Weekly and daily orchestration → Chart and news review: reviews charts
pipeline.py - Chart and news review → Anthropic API: requests review
README.md - Weekly and daily orchestration → Review gallery: writes review gallery
pipeline.py - Weekly and daily orchestration → Charts and Telegram cards: renders and sends cards
pipeline.py - Charts and Telegram cards → Telegram: sends alerts
report.py - Operator → Manual broker action: executes manually
README.md - Operator → Weekly and daily orchestration: approves taken trades
README.md - Telegram → CLI commands: polls approvals
README.md - Weekly and daily orchestration → Sizing and exits: checks daily exits
README.md - Sizing and exits → Indicator calculations: calculates trailing stops
risk.py - Weekly and daily orchestration → Position state: updates tracking state
README.md - Weekly and daily orchestration → Candidate and watchlist outputs: writes scan results
pipeline.py - Weekly and daily orchestration → Charts and Telegram cards: sends exit alerts
README.md