Skip to content

FinceptTerminal is a modern finance application offering advanced market analytics, investment research, and economic data tools, designed for interactive exploration and data-driven decision-making in a user-friendly environment.

fred and setup bugs fix

tilakpatel2272920a90a594
diff --git a/.gitignore b/.gitignore
index abc9285e1..68fa45be7 100644
--- a/.gitignore
+++ b/.gitignore
@@ -44,6 +44,10 @@ venv/
.pdm-python
.pdm-build
+# ── setup.sh runtime directories ─────────────────────────────
+.qt/
+.aqt-venv/
+
# ── IDE and editor ───────────────────────────────────────────
.idea/
.vscode/
diff --git a/README.md b/README.md
index b9e527bdf..68125b0c7 100644
--- a/README.md
+++ b/README.md
@@ -24,7 +24,7 @@ State-of-the-art financial intelligence platform with CFA-level analytics, AI au
[📥 Download](https://github.com/Fincept-Corporation/FinceptTerminal/releases) · [📚 Docs](https://github.com/Fincept-Corporation/FinceptTerminal/tree/main/docs) · [💬 Discussions](https://github.com/Fincept-Corporation/FinceptTerminal/discussions) · [💬 Discord](https://discord.gg/ae87a8ygbN) · [🤝 Partner](https://github.com/Fincept-Corporation/FinceptTerminal/blob/main/docs/COMMERCIAL_LICENSE.md)
-![Fincept Terminal](https://raw.githubusercontent.com/Fincept-Corporation/FinceptTerminal/main/images/Dashboard.png)
+![Fincept Terminal](https://raw.githubusercontent.com/Fincept-Corporation/FinceptTerminal/main/images/FinceptBanner.png)
<table>
<tr>
diff --git a/fincept-qt/scripts/fred_data.py b/fincept-qt/scripts/fred_data.py
index 5eb0bb87c..af26a9540 100644
--- a/fincept-qt/scripts/fred_data.py
+++ b/fincept-qt/scripts/fred_data.py
@@ -27,7 +27,10 @@ session.mount('https://', adapter)
def make_fred_request(endpoint: str, params: Dict[str, Any]) -> Dict:
"""Make request to FRED API using connection pool"""
if not FRED_API_KEY:
- return {"error": "FRED API key not configured"}
+ return {
+ "error": "FRED API key not configured. Set FRED_API_KEY environment variable.",
+ "error_code": "MISSING_API_KEY",
+ }
params['api_key'] = FRED_API_KEY
params['file_type'] = 'json'
@@ -35,10 +38,30 @@ def make_fred_request(endpoint: str, params: Dict[str, Any]) -> Dict:
url = f"{FRED_API_BASE}/{endpoint}"
try:
response = session.get(url, params=params, timeout=15)
+ if response.status_code in (401, 403):
+ return {
+ "error": "FRED rejected the API key (HTTP {}).".format(response.status_code),
+ "error_code": "INVALID_API_KEY",
+ }
+ if response.status_code == 429:
+ retry_after = response.headers.get("Retry-After", "")
+ try:
+ retry_seconds = int(retry_after)
+ except (TypeError, ValueError):
+ retry_seconds = 60
+ return {
+ "error": "FRED rate limit hit. Retry in ~{}s.".format(retry_seconds),
+ "error_code": "RATE_LIMITED",
+ "retry_after": retry_seconds,
+ }
response.raise_for_status()
return response.json()
+ except requests.exceptions.HTTPError as e:
+ return {"error": str(e), "error_code": "HTTP_ERROR"}
+ except requests.exceptions.Timeout:
+ return {"error": "FRED request timed out.", "error_code": "TIMEOUT"}
except requests.exceptions.RequestException as e:
- return {"error": str(e)}
+ return {"error": str(e), "error_code": "REQUEST_FAILED"}
def get_series(series_id: str, start_date: Optional[str] = None, end_date: Optional[str] = None,
diff --git a/fincept-qt/scripts/fred_economic_data.py b/fincept-qt/scripts/fred_economic_data.py
index c57950e18..53ffe0c62 100644
--- a/fincept-qt/scripts/fred_economic_data.py
+++ b/fincept-qt/scripts/fred_economic_data.py
@@ -85,6 +85,11 @@ PCE_SERIES = {
def _make_request(endpoint: str, params: Dict = None) -> Any:
+ if not API_KEY:
+ return {
+ "error": "FRED API key not configured. Set FRED_API_KEY environment variable.",
+ "error_code": "MISSING_API_KEY",
+ }
url = f"{BASE_URL}/{endpoint}" if not endpoint.startswith('http') else endpoint
if params is None:
params = {}
@@ -92,14 +97,32 @@ def _make_request(endpoint: str, params: Dict = None) -> Any:
params["file_type"] = "json"
try:
response = session.get(url, params=params, timeout=30)
+ if response.status_code in (401, 403):
+ return {
+ "error": f"FRED rejected the API key (HTTP {response.status_code}).",
+ "error_code": "INVALID_API_KEY",
+ }
+ if response.status_code == 429:
+ retry_after = response.headers.get("Retry-After", "")
+ try:
+ retry_seconds = int(retry_after)
+ except (TypeError, ValueError):
+ retry_seconds = 60
+ return {
+ "error": f"FRED rate limit hit. Retry in ~{retry_seconds}s.",
+ "error_code": "RATE_LIMITED",
+ "retry_after": retry_seconds,
+ }
response.raise_for_status()
return response.json()
except requests.exceptions.HTTPError as e:
- return {"error": f"HTTP {e.response.status_code}: {str(e)}"}
+ return {"error": f"HTTP {e.response.status_code}: {str(e)}", "error_code": "HTTP_ERROR"}
+ except requests.exceptions.Timeout:
+ return {"error": "FRED request timed out.", "error_code": "TIMEOUT"}
except requests.exceptions.RequestException as e:
- return {"error": f"Request failed: {str(e)}"}
+ return {"error": f"Request failed: {str(e)}", "error_code": "REQUEST_FAILED"}
except (json.JSONDecodeError, ValueError) as e:
- return {"error": f"JSON decode error: {str(e)}"}
+ return {"error": f"JSON decode error: {str(e)}", "error_code": "PARSE_ERROR"}
def _get_series_observations(series_id: str, start_date: str = "", end_date: str = "") -> Dict:
@@ -124,7 +147,7 @@ def _get_series_observations(series_id: str, start_date: str = "", end_date: str
def get_yield_curve(start_date: str = "", end_date: str = "") -> Dict:
if not API_KEY:
- return {"error": "FRED_API_KEY environment variable not set"}
+ return {"error": "FRED_API_KEY environment variable not set", "error_code": "MISSING_API_KEY"}
result = {"yield_curve": {}, "spreads": {}, "start_date": start_date, "end_date": end_date}
tenor_series = {k: v for k, v in YIELD_CURVE_SERIES.items() if "spread" not in k}
spread_series = {k: v for k, v in YIELD_CURVE_SERIES.items() if "spread" in k}
@@ -140,7 +163,7 @@ def get_yield_curve(start_date: str = "", end_date: str = "") -> Dict:
def get_money_supply(measure: str = "m2", start_date: str = "", end_date: str = "") -> Dict:
if not API_KEY:
- return {"error": "FRED_API_KEY environment variable not set"}
+ return {"error": "FRED_API_KEY environment variable not set", "error_code": "MISSING_API_KEY"}
if measure == "all":
result = {"money_supply": {}}
for name, series_id in MONEY_SUPPLY_SERIES.items():
@@ -156,7 +179,7 @@ def get_money_supply(measure: str = "m2", start_date: str = "", end_date: str =
def get_credit_conditions(series_id: str = "fed_funds_rate", start_date: str = "", end_date: str = "") -> Dict:
if not API_KEY:
- return {"error": "FRED_API_KEY environment variable not set"}
+ return {"error": "FRED_API_KEY environment variable not set", "error_code": "MISSING_API_KEY"}
resolved_id = CREDIT_CONDITION_SERIES.get(series_id, series_id)
data = _get_series_observations(resolved_id, start_date, end_date)
data["requested_series"] = series_id
@@ -166,7 +189,7 @@ def get_credit_conditions(series_id: str = "fed_funds_rate", start_date: str = "
def get_financial_stress_index(start_date: str = "", end_date: str = "") -> Dict:
if not API_KEY:
- return {"error": "FRED_API_KEY environment variable not set"}
+ return {"error": "FRED_API_KEY environment variable not set", "error_code": "MISSING_API_KEY"}
result = {"stress_indices": {}, "start_date": start_date, "end_date": end_date}
for name, series_id in FINANCIAL_STRESS_SERIES.items():
result["stress_indices"][name] = _get_series_observations(series_id, start_date, end_date)
@@ -176,7 +199,7 @@ def get_financial_stress_index(start_date: str = "", end_date: str = "") -> Dict
def get_consumer_sentiment(start_date: str = "", end_date: str = "") -> Dict:
if not API_KEY:
- return {"error": "FRED_API_KEY environment variable not set"}
+ return {"error": "FRED_API_KEY environment variable not set", "error_code": "MISSING_API_KEY"}
result = {"sentiment": {}, "start_date": start_date, "end_date": end_date}
for name, series_id in CONSUMER_SENTIMENT_SERIES.items():
result["sentiment"][name] = _get_series_observations(series_id, start_date, end_date)
@@ -186,7 +209,7 @@ def get_consumer_sentiment(start_date: str = "", end_date: str = "") -> Dict:
def get_pce_inflation(start_date: str = "", end_date: str = "") -> Dict:
if not API_KEY:
- return {"error": "FRED_API_KEY environment variable not set"}
+ return {"error": "FRED_API_KEY environment variable not set", "error_code": "MISSING_API_KEY"}
result = {"pce": {}, "start_date": start_date, "end_date": end_date}
for name, series_id in PCE_SERIES.items():
result["pce"][name] = _get_series_observations(series_id, start_date, end_date)
diff --git a/fincept-qt/src/screens/economics/panels/EconomicsPresets.h b/fincept-qt/src/screens/economics/panels/EconomicsPresets.h
new file mode 100644
index 000000000..f5a3722a0
--- /dev/null
+++ b/fincept-qt/src/screens/economics/panels/EconomicsPresets.h
@@ -0,0 +1,52 @@
+// src/screens/economics/panels/EconomicsPresets.h
+// Shared FRED preset list — single source of truth for FredPanel and the
+// MarketDataNodes "FRED Economic Data" workflow node.
+#pragma once
+
+#include <QPair>
+#include <QString>
+#include <QStringList>
+#include <QVector>
+
+namespace fincept::screens {
+
+struct FredPreset {
+ QString label; // human-readable, e.g. "Real GDP (GDPC1)"
+ QString series_id; // FRED series id, e.g. "GDPC1"
+};
+
+inline const QVector<FredPreset>& fred_presets() {
+ static const QVector<FredPreset> kPresets = {
+ {"-- Custom series ID --", ""},
+ {"Real GDP (GDPC1)", "GDPC1"},
+ {"Nominal GDP (GDP)", "GDP"},
+ {"CPI All Items (CPIAUCSL)", "CPIAUCSL"},
+ {"Core CPI (CPILFESL)", "CPILFESL"},
+ {"Unemployment Rate (UNRATE)", "UNRATE"},
+ {"Federal Funds Rate (FEDFUNDS)", "FEDFUNDS"},
+ {"10-Year Treasury Yield (DGS10)", "DGS10"},
+ {"2-Year Treasury Yield (DGS2)", "DGS2"},
+ {"30-Year Mortgage Rate (MORTGAGE30US)", "MORTGAGE30US"},
+ {"M2 Money Supply (M2SL)", "M2SL"},
+ {"Personal Savings Rate (PSAVERT)", "PSAVERT"},
+ {"Industrial Production (INDPRO)", "INDPRO"},
+ {"Retail Sales (RSXFS)", "RSXFS"},
+ {"Housing Starts (HOUST)", "HOUST"},
+ {"Trade Balance (BOPGSTB)", "BOPGSTB"},
+ {"VIX Volatility Index (VIXCLS)", "VIXCLS"},
+ {"S&P 500 (SP500)", "SP500"},
+ };
+ return kPresets;
+}
+
+// Series IDs only — for use as a workflow-node dropdown where users pick a code.
+inline QStringList fred_preset_series_ids() {
+ QStringList ids;
+ for (const auto& p : fred_presets()) {
+ if (!p.series_id.isEmpty())
+ ids.append(p.series_id);
+ }
+ return ids;
+}
+
+} // namespace fincept::screens
diff --git a/fincept-qt/src/screens/economics/panels/FredPanel.cpp b/fincept-qt/src/screens/economics/panels/FredPanel.cpp
index 0661e5f69..9e05d0d92 100644
--- a/fincept-qt/src/screens/economics/panels/FredPanel.cpp
+++ b/fincept-qt/src/screens/economics/panels/FredPanel.cpp
@@ -2,6 +2,7 @@
#include "screens/economics/panels/FredPanel.h"
#include "core/logging/Logger.h"
+#include "screens/economics/panels/EconomicsPresets.h"
#include "services/economics/EconomicsService.h"
#include <QHBoxLayout>
@@ -18,27 +19,6 @@ static constexpr const char* kFredSourceId = "fred";
static constexpr const char* kFredColor = "#EF4444"; // red
} // namespace
-static const QList<QPair<QString, QString>> kFredPresets = {
- {"-- Custom series ID --", ""},
- {"Real GDP (GDPC1)", "GDPC1"},
- {"Nominal GDP (GDP)", "GDP"},
- {"CPI All Items (CPIAUCSL)", "CPIAUCSL"},
- {"Core CPI (CPILFESL)", "CPILFESL"},
- {"Unemployment Rate (UNRATE)", "UNRATE"},
- {"Federal Funds Rate (FEDFUNDS)", "FEDFUNDS"},
- {"10-Year Treasury Yield (DGS10)", "DGS10"},
- {"2-Year Treasury Yield (DGS2)", "DGS2"},
- {"30-Year Mortgage Rate (MORTGAGE30US)", "MORTGAGE30US"},
- {"M2 Money Supply (M2SL)", "M2SL"},
- {"Personal Savings Rate (PSAVERT)", "PSAVERT"},
- {"Industrial Production (INDPRO)", "INDPRO"},
- {"Retail Sales (RSXFS)", "RSXFS"},
- {"Housing Starts (HOUST)", "HOUST"},
- {"Trade Balance (BOPGSTB)", "BOPGSTB"},
- {"VIX Volatility Index (VIXCLS)", "VIXCLS"},
- {"S&P 500 (SP500)", "SP500"},
-};
-
FredPanel::FredPanel(QWidget* parent) : EconPanelBase(kFredSourceId, kFredColor, parent) {
build_base_ui(this);
connect(&services::EconomicsService::instance(), &services::EconomicsService::result_ready, this,
@@ -55,8 +35,8 @@ void FredPanel::build_controls(QHBoxLayout* thl) {
lbl1->setStyleSheet(ctrl_label_style());
preset_combo_ = new QComboBox;
- for (const auto& p : kFredPresets)
- preset_combo_->addItem(p.first, p.second);
+ for (const auto& p : fred_presets())
+ preset_combo_->addItem(p.label, p.series_id);
preset_combo_->setFixedHeight(26);
preset_combo_->setMinimumWidth(200);
connect(preset_combo_, &QComboBox::currentIndexChanged, this, [this](int idx) {
@@ -97,8 +77,23 @@ void FredPanel::on_result(const QString& request_id, const services::EconomicsRe
if (result.source_id != kFredSourceId)
return;
if (!result.success) {
- // Check for API key error specifically
- if (result.error.contains("API key") || result.error.contains("api_key")) {
+ // EconomicsService prefixes errors with "[CODE] " when the script
+ // returns a structured error_code. Branch on those for friendly UX.
+ if (result.error.startsWith("[MISSING_API_KEY]")) {
+ show_error("FRED API key not configured.\n"
+ "Set FRED_API_KEY environment variable.\n"
+ "Free key at: fred.stlouisfed.org/docs/api/api_key.html");
+ } else if (result.error.startsWith("[INVALID_API_KEY]")) {
+ show_error("FRED rejected your API key.\n"
+ "Check FRED_API_KEY — re-issue one at:\n"
+ "fred.stlouisfed.org/docs/api/api_key.html");
+ } else if (result.error.startsWith("[RATE_LIMITED]")) {
+ show_error("FRED rate-limit hit. Try again in a moment.\n"
+ + result.error.mid(QStringLiteral("[RATE_LIMITED] ").size()));
+ } else if (result.error.startsWith("[TIMEOUT]")) {
+ show_error("FRED request timed out — check your network and retry.");
+ } else if (result.error.contains("API key") || result.error.contains("api_key")) {
+ // Legacy un-coded message fallback
show_error("FRED API key not configured.\n"
"Set FRED_API_KEY environment variable.\n"
"Free key at: fred.stlouisfed.org/docs/api/api_key.html");
diff --git a/fincept-qt/src/services/economics/EconomicsService.cpp b/fincept-qt/src/services/economics/EconomicsService.cpp
index ba479dd81..52665d893 100644
--- a/fincept-qt/src/services/economics/EconomicsService.cpp
+++ b/fincept-qt/src/services/economics/EconomicsService.cpp
@@ -106,7 +106,10 @@ void EconomicsService::execute(const QString& source_id, const QString& script,
if (res.data.contains("error") && !res.data["error"].isNull() && !res.data["error"].toString().isEmpty() &&
!res.data.contains("data")) {
res.success = false;
- res.error = res.data["error"].toString();
+ const QString error_code = res.data.value("error_code").toString();
+ const QString message = res.data["error"].toString();
+ // Prefix with [CODE] so panels can branch on it without a schema change.
+ res.error = error_code.isEmpty() ? message : (QStringLiteral("[") + error_code + QStringLiteral("] ") + message);
emit self->result_ready(request_id, res);
return;
}
diff --git a/fincept-qt/src/services/workflow/nodes/MarketDataNodes.cpp b/fincept-qt/src/services/workflow/nodes/MarketDataNodes.cpp
index 72195b6f0..03833645c 100644
--- a/fincept-qt/src/services/workflow/nodes/MarketDataNodes.cpp
+++ b/fincept-qt/src/services/workflow/nodes/MarketDataNodes.cpp
@@ -1,6 +1,7 @@
#include "services/workflow/nodes/MarketDataNodes.h"
#include "python/PythonRunner.h"
+#include "screens/economics/panels/EconomicsPresets.h"
#include "services/workflow/NodeRegistry.h"
#include <QJsonDocument>
@@ -198,46 +199,87 @@ void register_market_data_nodes(NodeRegistry& registry) {
registry.register_type({
.type_id = "market.get_economics",
- .display_name = "Economic Data",
+ .display_name = "FRED Economic Data",
.category = "Market Data",
- .description = "Fetch economic indicators (GDP, CPI, unemployment, etc.)",
+ .description = "Fetch a FRED macroeconomic series (GDP, CPI, Treasury yields, Fed Funds, etc.)",
.icon_text = "$",
.accent_color = "#2563eb",
- .version = 1,
+ .version = 2,
.inputs = {{"input_0", "Data In", PortDirection::Input, ConnectionType::Main}},
.outputs = {{"output_main", "Main", PortDirection::Output, ConnectionType::EconomicData}},
.parameters =
{
- {"indicator",
- "Indicator",
+ {"preset",
+ "Preset",
"select",
- "GDP",
- {"GDP", "CPI", "UNEMPLOYMENT", "INTEREST_RATE", "INFLATION", "RETAIL_SALES"},
- ""},
- {"country", "Country", "string", "US", {}, "Country code"},
+ "GDPC1",
+ fincept::screens::fred_preset_series_ids(),
+ "Pick a common series, or use Series ID below for any FRED code"},
+ {"series_id", "Series ID (override)", "string", "", {},
+ "Optional FRED series id (e.g. GS10). Overrides Preset when set."},
+ {"start_date", "Start Date", "string", "", {}, "YYYY-MM-DD (optional)"},
+ {"end_date", "End Date", "string", "", {}, "YYYY-MM-DD (optional)"},
+ {"frequency", "Frequency", "select", "",
+ {"", "d", "w", "m", "q", "a"},
+ "Output frequency: d=daily, w=weekly, m=monthly, q=quarterly, a=annual"},
+ {"transform", "Transform", "select", "",
+ {"", "chg", "pch", "log"},
+ "chg=change, pch=percent change, log=natural log"},
},
.execute =
[](const QJsonObject& params, const QVector<QJsonValue>&,
std::function<void(bool, QJsonValue, QString)> cb) {
- // Map indicator names to FRED series IDs
- QString indicator = params.value("indicator").toString("GDP");
- QString series_id;
- if (indicator == "GDP")
- series_id = "GDP";
- else if (indicator == "CPI")
- series_id = "CPIAUCSL";
- else if (indicator == "UNEMPLOYMENT")
- series_id = "UNRATE";
- else if (indicator == "INTEREST_RATE")
- series_id = "FEDFUNDS";
- else if (indicator == "INFLATION")
- series_id = "T10YIE";
- else if (indicator == "RETAIL_SALES")
- series_id = "RSAFS";
- else
- series_id = indicator;
+ QString series_id = params.value("series_id").toString().trimmed();
+ if (series_id.isEmpty())
+ series_id = params.value("preset").toString("GDPC1");
+
+ QStringList args = {"series", series_id};
+ const QString start = params.value("start_date").toString().trimmed();
+ const QString end = params.value("end_date").toString().trimmed();
+ const QString freq = params.value("frequency").toString().trimmed();
+ const QString transform = params.value("transform").toString().trimmed();
+
+ // fred_data.py series <id> [start] [end] [frequency] [transform] — positional.
+ // Only emit trailing args if needed; pad earlier ones with empty strings.
+ if (!start.isEmpty() || !end.isEmpty() || !freq.isEmpty() || !transform.isEmpty())
+ args.append(start);
+ if (!end.isEmpty() || !freq.isEmpty() || !transform.isEmpty())
+ args.append(end);
+ if (!freq.isEmpty() || !transform.isEmpty())
+ args.append(freq);
+ if (!transform.isEmpty())
+ args.append(transform);
+
+ run_python_json("fred_data.py", args, cb);
+ },
+ });
- run_python_json("fred_data.py", {"series", series_id}, cb);
+ registry.register_type({
+ .type_id = "market.get_yield_curve",
+ .display_name = "US Treasury Yield Curve",
+ .category = "Market Data",
+ .description = "Fetch the full US Treasury yield curve (1m–30y) plus 10y-2y / 10y-3m spreads from FRED",
+ .icon_text = "$",
+ .accent_color = "#2563eb",
+ .version = 1,
+ .inputs = {{"input_0", "Data In", PortDirection::Input, ConnectionType::Main}},
+ .outputs = {{"output_main", "Main", PortDirection::Output, ConnectionType::EconomicData}},
+ .parameters =
+ {
+ {"start_date", "Start Date", "string", "", {}, "YYYY-MM-DD (optional)"},
+ {"end_date", "End Date", "string", "", {}, "YYYY-MM-DD (optional)"},
+ },
+ .execute =
+ [](const QJsonObject& params, const QVector<QJsonValue>&,
+ std::function<void(bool, QJsonValue, QString)> cb) {
+ QStringList args = {"yield_curve"};
+ const QString start = params.value("start_date").toString().trimmed();
+ const QString end = params.value("end_date").toString().trimmed();
+ if (!start.isEmpty() || !end.isEmpty())
+ args.append(start);
+ if (!end.isEmpty())
+ args.append(end);
+ run_python_json("fred_economic_data.py", args, cb);
},
});
diff --git a/images/Dashboard.png b/images/Dashboard.png
index b9937fbce..3e14460c1 100644
Binary files a/images/Dashboard.png and b/images/Dashboard.png differ
diff --git a/images/FinceptBanner.png b/images/FinceptBanner.png
new file mode 100644
index 000000000..3e14460c1
Binary files /dev/null and b/images/FinceptBanner.png differ
diff --git a/setup.sh b/setup.sh
index e70b65634..bb016c454 100755
--- a/setup.sh
+++ b/setup.sh
@@ -53,15 +53,33 @@ version_ge() {
# ── Step 1: System dependencies (build tools only) ──────────
echo "[1/7] Installing system build tools..."
if [ "$PLATFORM" = "linux" ]; then
- command -v apt-get &>/dev/null || fail "apt-get not found. Install cmake / ninja-build / g++ / python3.11 / python3-pip manually."
- sudo apt-get update -qq
- sudo apt-get install -y --no-install-recommends \
- git cmake ninja-build g++ \
- python3 python3-pip python3-venv \
- libgl1-mesa-dev libglu1-mesa-dev \
- libxkbcommon-dev libxkbcommon-x11-dev \
- libfontconfig1 libdbus-1-3 \
- pkg-config curl
+ if command -v apt-get &>/dev/null; then
+ sudo apt-get update -qq
+ sudo apt-get install -y --no-install-recommends \
+ git cmake ninja-build g++ \
+ python3 python3-pip python3-venv \
+ libgl1-mesa-dev libglu1-mesa-dev \
+ libxkbcommon-dev libxkbcommon-x11-dev \
+ libfontconfig1 libdbus-1-3 \
+ pkg-config curl
+ elif command -v pacman &>/dev/null; then
+ sudo pacman -Sy --noconfirm --needed \
+ base-devel git cmake ninja \
+ python python-pip \
+ mesa glu libxkbcommon \
+ fontconfig dbus \
+ pkgconf curl
+ elif command -v dnf &>/dev/null; then
+ sudo dnf install -y \
+ git cmake ninja-build gcc-c++ \
+ python3 python3-pip python3-virtualenv \
+ mesa-libGL-devel mesa-libGLU-devel \
+ libxkbcommon-devel \
+ fontconfig dbus-libs \
+ pkgconfig curl
+ else
+ info "No recognised package manager found. Ensure cmake, ninja, g++, python3, and Qt build dependencies are installed manually."
+ fi
elif [ "$PLATFORM" = "macos" ]; then
if ! command -v brew &>/dev/null; then
[ "$CI_MODE" = true ] && fail "Homebrew not found in CI environment."
@@ -119,18 +137,24 @@ else
info "Installing Qt ${QT_VERSION} via aqtinstall to $QT_INSTALL_ROOT ..."
# aqtinstall is a stable community tool that downloads exact Qt versions
# from the official Qt mirror. Much smaller than Qt Online Installer and scriptable.
- "$PYTHON" -m pip install --user --quiet --upgrade aqtinstall
- AQT="$("$PYTHON" -m pip show aqtinstall >/dev/null 2>&1 && "$PYTHON" -m aqt help >/dev/null 2>&1 && echo "$PYTHON -m aqt" || echo "")"
- [ -n "$AQT" ] || fail "aqtinstall did not install correctly."
+ # Use an isolated venv to avoid PEP 668 "externally-managed-environment" errors
+ # on Arch Linux, Ubuntu 23.04+, and other distros that block global pip installs.
+ AQT_VENV="$SCRIPT_DIR/.aqt-venv"
+ "$PYTHON" -m venv "$AQT_VENV"
+ "$AQT_VENV/bin/pip" install --quiet --upgrade aqtinstall
+ AQT="$AQT_VENV/bin/aqt"
+ [ -x "$AQT" ] || fail "aqtinstall did not install correctly."
# Qt host/target/arch
+ # AQT_ARCH is the argument passed to aqt (aqtinstall 3.x uses linux_gcc_64 on Linux).
+ # QT_KIT is the subdirectory aqtinstall actually creates on disk (always gcc_64).
if [ "$PLATFORM" = "linux" ]; then
- AQT_HOST="linux" ; AQT_TARGET="desktop" ; AQT_ARCH="gcc_64"
+ AQT_HOST="linux" ; AQT_TARGET="desktop" ; AQT_ARCH="linux_gcc_64"
else
AQT_HOST="mac" ; AQT_TARGET="desktop" ; AQT_ARCH="macos"
fi
# Modules required to compile Fincept (match find_package COMPONENTS)
AQT_MODULES="qtcharts qtwebsockets qtmultimedia qtspeech"
- $AQT install-qt "$AQT_HOST" "$AQT_TARGET" "$QT_VERSION" "$AQT_ARCH" \
+ "$AQT" install-qt "$AQT_HOST" "$AQT_TARGET" "$QT_VERSION" "$AQT_ARCH" \
--outputdir "$QT_INSTALL_ROOT" \
--modules $AQT_MODULES \
|| fail "aqtinstall failed. Check internet connection or install Qt ${QT_VERSION} manually from https://www.qt.io/download-qt-installer"