autoscholar-cli 1.0.0

package/python/clients/fmp_client.py

@@ -0,0 +1,64 @@
+"""
+FMP (Financial Modeling Prep) Python Client
+Pre-loaded in AutoScholar Python execution environment
+"""
+import os
+import requests
+import pandas as pd
+
+class FMPClient:
+    BASE_URL = "https://financialmodelingprep.com/stable"
+
+    def __init__(self, api_key=None):
+        self.api_key = api_key or os.environ.get("FMP_API_KEY", "")
+
+    def _request(self, endpoint, params=None):
+        params = params or {}
+        params["apikey"] = self.api_key
+        resp = requests.get(f"{self.BASE_URL}/{endpoint}", params=params, timeout=60)
+        resp.raise_for_status()
+        return resp.json()
+
+    def get_quote(self, symbol):
+        return self._request("quote", {"symbol": symbol})
+
+    def get_historical_prices(self, symbol, from_date=None, to_date=None):
+        params = {"symbol": symbol}
+        if from_date: params["from"] = from_date
+        if to_date: params["to"] = to_date
+        data = self._request("historical-price-eod/full", params)
+        historical = data if isinstance(data, list) else data.get("historical", [])
+        return pd.DataFrame(historical)
+
+    def get_income_statement(self, symbol, period="annual", limit=10):
+        data = self._request("income-statement", {"symbol": symbol, "period": period, "limit": limit})
+        return pd.DataFrame(data if isinstance(data, list) else [])
+
+    def get_balance_sheet(self, symbol, period="annual", limit=10):
+        data = self._request("balance-sheet-statement", {"symbol": symbol, "period": period, "limit": limit})
+        return pd.DataFrame(data if isinstance(data, list) else [])
+
+    def get_cash_flow(self, symbol, period="annual", limit=10):
+        data = self._request("cash-flow-statement", {"symbol": symbol, "period": period, "limit": limit})
+        return pd.DataFrame(data if isinstance(data, list) else [])
+
+    def get_key_metrics(self, symbol, period="annual", limit=10):
+        data = self._request("key-metrics", {"symbol": symbol, "period": period, "limit": limit})
+        return pd.DataFrame(data if isinstance(data, list) else [])
+
+    def get_financial_ratios(self, symbol, period="annual", limit=10):
+        data = self._request("ratios", {"symbol": symbol, "period": period, "limit": limit})
+        return pd.DataFrame(data if isinstance(data, list) else [])
+
+    def get_company_profile(self, symbol):
+        return self._request("profile", {"symbol": symbol})
+
+    def get_stock_news(self, symbol, limit=50):
+        return self._request("stock-news", {"tickers": symbol, "limit": limit})
+
+    def search(self, query, limit=10):
+        return self._request("search", {"query": query, "limit": limit})
+
+
+# Pre-instantiate
+fmp = FMPClient()

package/python/clients/fred_client.py

@@ -0,0 +1,57 @@
+"""
+FRED (Federal Reserve Economic Data) Python Client
+Pre-loaded in AutoScholar Python execution environment
+"""
+import os
+import requests
+import pandas as pd
+
+class FREDClient:
+    BASE_URL = "https://api.stlouisfed.org/fred"
+
+    def __init__(self, api_key=None):
+        self.api_key = api_key or os.environ.get("FRED_API_KEY", "")
+
+    def _request(self, endpoint, params=None):
+        params = params or {}
+        params["api_key"] = self.api_key
+        params["file_type"] = "json"
+        resp = requests.get(f"{self.BASE_URL}/{endpoint}", params=params, timeout=30)
+        resp.raise_for_status()
+        return resp.json()
+
+    def get_series_df(self, series_id, observation_start=None, observation_end=None,
+                      units=None, frequency=None):
+        """Get FRED series as a pandas DataFrame"""
+        params = {"series_id": series_id}
+        if observation_start: params["observation_start"] = observation_start
+        if observation_end: params["observation_end"] = observation_end
+        if units: params["units"] = units
+        if frequency: params["frequency"] = frequency
+
+        data = self._request("series/observations", params)
+        obs = data.get("observations", [])
+        df = pd.DataFrame(obs)
+        if len(df) > 0:
+            df["date"] = pd.to_datetime(df["date"])
+            df["value"] = pd.to_numeric(df["value"], errors="coerce")
+            df = df[["date", "value"]].dropna()
+            df.columns = ["date", series_id]
+        return df
+
+    def get_series(self, series_id):
+        """Get series metadata"""
+        data = self._request("series", {"series_id": series_id})
+        return data.get("seriess", [{}])[0]
+
+    def search_series(self, search_text, limit=20):
+        """Search for FRED series"""
+        data = self._request("series/search", {"search_text": search_text, "limit": limit})
+        return data.get("seriess", [])
+
+    def get_category(self, category_id):
+        return self._request("category", {"category_id": category_id})
+
+
+# Pre-instantiate
+fred = FREDClient()

package/python/clients/macro_clients.py

@@ -0,0 +1,81 @@
+"""
+World Bank, IMF, OECD Python Clients
+Free APIs — no API key required
+Pre-loaded in AutoScholar Python execution environment
+"""
+import requests
+import pandas as pd
+
+class WorldBankClient:
+    BASE_URL = "https://api.worldbank.org/v2"
+
+    def get_indicator(self, indicator, country="all", date_range="2000:2025", per_page=500):
+        """Get World Bank indicator data as DataFrame"""
+        resp = requests.get(
+            f"{self.BASE_URL}/country/{country}/indicator/{indicator}",
+            params={"format": "json", "date": date_range, "per_page": per_page},
+            timeout=20
+        )
+        resp.raise_for_status()
+        data = resp.json()
+        if isinstance(data, list) and len(data) > 1:
+            records = data[1] or []
+            rows = [{
+                "country": r.get("country", {}).get("value", ""),
+                "country_code": r.get("countryiso3code", ""),
+                "date": r.get("date", ""),
+                "value": r.get("value"),
+                "indicator": r.get("indicator", {}).get("id", indicator)
+            } for r in records if r.get("value") is not None]
+            return pd.DataFrame(rows)
+        return pd.DataFrame()
+
+    def search_indicators(self, query, per_page=50):
+        resp = requests.get(
+            f"{self.BASE_URL}/indicator",
+            params={"format": "json", "per_page": per_page},
+            timeout=15
+        )
+        resp.raise_for_status()
+        data = resp.json()
+        if isinstance(data, list) and len(data) > 1:
+            return [i for i in data[1] if query.lower() in i.get("name", "").lower()]
+        return []
+
+
+class IMFClient:
+    BASE_URL = "http://dataservices.imf.org/REST/SDMX_JSON.svc"
+
+    def get_data(self, dataset, frequency, country, indicator, start=None, end=None):
+        """Get IMF dataset"""
+        url = f"{self.BASE_URL}/CompactData/{dataset}/{frequency}.{country}.{indicator}"
+        params = {}
+        if start: params["startPeriod"] = start
+        if end: params["endPeriod"] = end
+        resp = requests.get(url, params=params, timeout=20)
+        resp.raise_for_status()
+        return resp.json()
+
+    def get_weo(self, country="US", subject="NGDP_RPCH"):
+        """Get World Economic Outlook data"""
+        return self.get_data("WEO", "A", country, subject)
+
+
+class OECDClient:
+    BASE_URL = "https://sdmx.oecd.org/public/rest"
+
+    def get_data(self, dataflow, key="all", start=None, end=None):
+        """Get OECD dataflow"""
+        url = f"{self.BASE_URL}/data/{dataflow}/{key}"
+        params = {"format": "jsondata"}
+        if start: params["startPeriod"] = start
+        if end: params["endPeriod"] = end
+        resp = requests.get(url, params=params, timeout=20)
+        resp.raise_for_status()
+        return resp.json()
+
+
+# Pre-instantiate
+wb = WorldBankClient()
+imf = IMFClient()
+oecd = OECDClient()

package/python/requirements.txt

@@ -0,0 +1,23 @@
+# Core (required)
+pandas>=2.0
+numpy>=1.24
+scipy>=1.10
+matplotlib>=3.7
+seaborn>=0.12
+scikit-learn>=1.3
+statsmodels>=0.14
+requests>=2.31
+
+# Econometrics (recommended)
+arch>=6.0
+linearmodels>=5.0
+
+# ML (optional)
+xgboost>=2.0
+lightgbm>=4.0
+
+# Optimization (optional)
+cvxpy>=1.4
+
+# Other (optional)
+fredapi>=0.5