Apppublic

Irram/IRRAM-financial-advice

sourceHugging Faceupdated 2mo agoView on Hugging Face

0likes

App README

🏦 Autonomous Financial Research & Investment Advisor

A multi-agent AI pipeline (Research Agent → Risk Agent → Recommendation Agent) built on Groq-hosted LLMs, with a Gradio UI for running on-demand or scheduled equity research.

Setup

1.Duplicate/clone this Space.
2.In Settings → Repository secrets, add the keys from the table below.
3.The Space will build automatically from requirements.txt and launch app.py.

🔑 Config Keys Required

Complete reference — use this to re-add anything if a secret ever gets deleted or you're setting up a fresh copy of this Space. Spelling matters exactly as shown.

Secret Name	Required?	Get it from	Used for
`GROQ_API_KEY`	Required	https://console.groq.com/keys	Powers the Research/Risk/Recommendation LLM agents. Without it, every analysis fails at the agent step.
`FINNHUB_API_KEY`	Required	https://finnhub.io/register	Core market data — quote, company profile, fundamentals, news. Without it, no analysis can run at all.
`TWELVE_DATA_API_KEY`	Optional	https://twelvedata.com/pricing	First fallback (800 requests/day free) for price chart / technical indicators when Finnhub's candle data isn't available for a ticker.
`ALPHA_VANTAGE_API_KEY`	Optional	https://www.alphavantage.co/support/#api-key	Second fallback (25 requests/day free — much tighter) for the same chart/indicator data, tried only if Twelve Data also can't get it.

Without the two optional keys, the app still works fully — chart and technical indicators just show "N/A" (with a specific explanation) on tickers Finnhub's free tier doesn't have candle data for, instead of a fallback filling the gap.

Files

—app.py — main Gradio application (data collection, agents, orchestrator, UI)
—requirements.txt — Python dependencies
—README.md — this file (also configures the Space via the YAML front matter above)

Notes

—This app calls the Finnhub REST API for market data (quotes, company profile, basic financials, news) and the Groq OpenAI-compatible endpoint for LLM inference. Scheduled jobs (via APScheduler) only run while the Space is awake — on free-tier Spaces that sleep after inactivity, scheduled jobs will pause when the Space sleeps and resume on the next wake-up.
—All generated analysis is for informational/educational purposes only and is not financial advice, as stated in the app's own disclaimers.
—Finnhub's free tier restricts historical daily candles (used for the 30-day chart, volatility, and drawdown) to paid plans for most exchanges. The app degrades gracefully when that data isn't available — it shows "N/A" for those fields and skips the chart rather than failing the whole report. Quotes, company profile, basic fundamentals, and news all work on the free tier.