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.

github actions

tilakpatel227f61dbe05f69
diff --git a/.github/workflows/build-artifacts.yml b/.github/workflows/build-artifacts.yml
index c5a5151fb..ffbb65326 100644
--- a/.github/workflows/build-artifacts.yml
+++ b/.github/workflows/build-artifacts.yml
@@ -2,6 +2,11 @@ name: Build Artifacts Only
on:
workflow_dispatch:
+ inputs:
+ description:
+ description: 'Build macOS artifacts for testing (unsigned builds require xattr command)'
+ required: false
+ default: 'See artifact download instructions below'
jobs:
build:
@@ -9,26 +14,16 @@ jobs:
fail-fast: false
matrix:
include:
- - platform: 'macos-latest'
+ - platform: 'macos-14'
args: '--target aarch64-apple-darwin'
os_name: 'macOS'
arch: 'arm64'
target: 'aarch64-apple-darwin'
- - platform: 'macos-latest'
+ - platform: 'macos-13'
args: '--target x86_64-apple-darwin'
os_name: 'macOS'
arch: 'x64'
target: 'x86_64-apple-darwin'
- - platform: 'ubuntu-latest'
- args: '--target x86_64-unknown-linux-gnu'
- os_name: 'Linux'
- arch: 'x64'
- target: 'x86_64-unknown-linux-gnu'
- - platform: 'windows-latest'
- args: '--target x86_64-pc-windows-msvc'
- os_name: 'Windows'
- arch: 'x64'
- target: 'x86_64-pc-windows-msvc'
runs-on: ${{ matrix.platform }}
@@ -36,26 +31,6 @@ jobs:
- name: Checkout repository
uses: actions/checkout@v4
- - name: Install dependencies (ubuntu only)
- if: matrix.platform == 'ubuntu-latest'
- run: |
- sudo apt-get update
- sudo apt-get install -y \
- libwebkit2gtk-4.1-dev \
- libjavascriptcoregtk-4.1-dev \
- libsoup-3.0-dev \
- build-essential \
- curl \
- wget \
- file \
- libssl-dev \
- libgtk-3-dev \
- libayatana-appindicator3-dev \
- librsvg2-dev \
- patchelf \
- libnss3-dev \
- libxss1 \
- libasound2-dev
- name: Rust setup
uses: dtolnay/rust-toolchain@stable
@@ -75,15 +50,14 @@ jobs:
- name: Verify project structure and resources
run: |
echo "Verifying project structure..."
- ls -la fincept-terminal-desktop/
- ls -la fincept-terminal-desktop/src-tauri/
- ls -la fincept-terminal-desktop/src-tauri/resources/
- echo "Checking requirements.txt exists..."
- if [ ! -f "fincept-terminal-desktop/src-tauri/resources/requirements.txt" ]; then
- echo "Error: requirements.txt not found!"
+ if [ ! -f "fincept-terminal-desktop/src-tauri/resources/requirements-numpy1.txt" ]; then
+ echo "Error: requirements-numpy1.txt not found!"
+ exit 1
+ fi
+ if [ ! -f "fincept-terminal-desktop/src-tauri/resources/requirements-numpy2.txt" ]; then
+ echo "Error: requirements-numpy2.txt not found!"
exit 1
fi
- echo "Checking scripts directory exists..."
if [ ! -d "fincept-terminal-desktop/src-tauri/resources/scripts" ]; then
echo "Error: scripts directory not found!"
exit 1
@@ -126,30 +100,15 @@ jobs:
echo "version=$VERSION" >> $GITHUB_OUTPUT
- # Find and rename artifacts based on platform
- if [[ "${{ matrix.platform }}" == "macos-latest" ]]; then
- # macOS builds
- if [[ "${{ matrix.arch }}" == "arm64" ]]; then
- SUFFIX="macOS-arm64"
- else
- SUFFIX="macOS-x64"
- fi
-
- find fincept-terminal-desktop/src-tauri/target/${{ matrix.target }}/release/bundle -name "*.dmg" -exec cp {} release-artifacts/FinceptTerminal-v${VERSION}-${SUFFIX}.dmg \; 2>/dev/null && echo "[OK] Found .dmg" || echo "[WARN] No .dmg found"
-
- elif [[ "${{ matrix.platform }}" == "ubuntu-latest" ]]; then
- # Linux builds
- SUFFIX="Linux-x64"
- find fincept-terminal-desktop/src-tauri/target/${{ matrix.target }}/release/bundle -name "*.AppImage" -exec cp {} release-artifacts/FinceptTerminal-v${VERSION}-${SUFFIX}.AppImage \; 2>/dev/null && echo "[OK] Found .AppImage" || echo "[WARN] No .AppImage found"
- find fincept-terminal-desktop/src-tauri/target/${{ matrix.target }}/release/bundle -name "*.deb" -exec cp {} release-artifacts/FinceptTerminal-v${VERSION}-${SUFFIX}.deb \; 2>/dev/null && echo "[OK] Found .deb" || echo "[WARN] No .deb found"
- find fincept-terminal-desktop/src-tauri/target/${{ matrix.target }}/release/bundle -name "*.rpm" -exec cp {} release-artifacts/FinceptTerminal-v${VERSION}-${SUFFIX}.rpm \; 2>/dev/null && echo "[OK] Found .rpm" || echo "[WARN] No .rpm found"
-
- elif [[ "${{ matrix.platform }}" == "windows-latest" ]]; then
- # Windows builds
- SUFFIX="Windows-x64"
- find fincept-terminal-desktop/src-tauri/target/${{ matrix.target }}/release/bundle -name "*.msi" -exec cp {} release-artifacts/FinceptTerminal-v${VERSION}-${SUFFIX}.msi \; 2>/dev/null && echo "[OK] Found .msi" || echo "[WARN] No .msi found"
+ # macOS builds only
+ if [[ "${{ matrix.arch }}" == "arm64" ]]; then
+ SUFFIX="macOS-arm64"
+ else
+ SUFFIX="macOS-x64"
fi
+ find fincept-terminal-desktop/src-tauri/target/${{ matrix.target }}/release/bundle -name "*.dmg" -exec cp {} release-artifacts/FinceptTerminal-v${VERSION}-${SUFFIX}.dmg \; 2>/dev/null && echo "[OK] Found .dmg" || echo "[WARN] No .dmg found"
+
# List what we found
echo "=== Release Artifacts ==="
ls -la release-artifacts/ || echo "No artifacts prepared"
@@ -166,3 +125,34 @@ jobs:
name: build-${{ matrix.os_name }}-${{ matrix.arch }}
path: release-artifacts/
retention-days: 30
+
+ - name: Installation Instructions
+ if: steps.prepare.outputs.artifact_count > 0
+ run: |
+ cat << 'EOF'
+
+ ========================================
+ macOS Installation Instructions
+ ========================================
+
+ IMPORTANT: This is an UNSIGNED build
+
+ After downloading the artifact:
+
+ 1. Extract the ZIP file
+ 2. Remove quarantine flag from DMG:
+
+ xattr -cr ~/Downloads/FinceptTerminal-*.dmg
+
+ 3. Open DMG and drag app to Applications
+ 4. Remove quarantine flag from app:
+
+ xattr -cr /Applications/FinceptTerminal.app
+
+ 5. Launch the app normally
+
+ Alternative: Right-click app -> Open -> Open
+
+ ========================================
+ EOF
+ shell: bash
diff --git a/README.md b/README.md
index 2a0f13052..82b6ec3d7 100644
--- a/README.md
+++ b/README.md
@@ -198,6 +198,23 @@ bun install && bun run tauri:dev
- [Rust](https://www.rust-lang.org/) (latest stable)
- Platform-specific dependencies (see [docs/GETTING_STARTED.md](docs/GETTING_STARTED.md))
+### macOS Installation (Unsigned Builds)
+
+⚠️ **Important:** Development and artifact builds are not signed with an Apple Developer certificate.
+
+**After downloading the DMG:**
+```bash
+# Remove quarantine flag from DMG
+xattr -cr ~/Downloads/FinceptTerminal-*.dmg
+
+# Open DMG, drag to Applications, then remove quarantine from app
+xattr -cr /Applications/FinceptTerminal.app
+```
+
+**Alternative:** Right-click the app → Select "Open" → Click "Open" in the warning dialog.
+
+Official releases from the [Releases page](https://github.com/Fincept-Corporation/FinceptTerminal/releases) include detailed installation instructions.
+
---
## 🛣️ What's Next
diff --git a/docs/GETTING_STARTED.md b/docs/GETTING_STARTED.md
index c306763a1..5d54319b0 100644
--- a/docs/GETTING_STARTED.md
+++ b/docs/GETTING_STARTED.md
@@ -504,6 +504,42 @@ font-size: 9px /* Dense data tables */
## 🐛 Troubleshooting
+### Issue: macOS won't open the app (Gatekeeper)
+
+**Symptoms:** "App is damaged and can't be opened" or "App can't be opened because it is from an unidentified developer"
+
+**Cause:** Unsigned development builds are blocked by macOS Gatekeeper
+
+**Solutions:**
+
+**Method 1: Remove Quarantine Flag (Recommended)**
+```bash
+# After downloading DMG
+xattr -cr ~/Downloads/FinceptTerminal-*.dmg
+
+# After dragging to Applications
+xattr -cr /Applications/FinceptTerminal.app
+
+# Now launch normally
+open /Applications/FinceptTerminal.app
+```
+
+**Method 2: Right-Click Method**
+1. **Right-click** (or Control+Click) on the app
+2. Select **"Open"** from the menu
+3. Click **"Open"** in the warning dialog
+4. App will launch and be remembered for future launches
+
+**Method 3: System Settings**
+1. Try to open the app normally (it will fail)
+2. Go to **System Settings** → **Privacy & Security**
+3. Scroll down and click **"Open Anyway"**
+4. Confirm by clicking **"Open"**
+
+**Why this happens:** Development and artifact builds are not signed with an Apple Developer certificate ($99/year). Official releases from GitHub Releases page may include signed versions.
+
+---
+
### Issue: `bun install` fails
**Symptoms:** Errors during `bun install`, missing modules
diff --git a/fincept-terminal-desktop/src-tauri/src/setup.rs b/fincept-terminal-desktop/src-tauri/src/setup.rs
index 9e3d59547..ec8611aad 100644
--- a/fincept-terminal-desktop/src-tauri/src/setup.rs
+++ b/fincept-terminal-desktop/src-tauri/src/setup.rs
@@ -130,44 +130,6 @@ fn check_bun(install_dir: &PathBuf) -> (bool, Option<String>) {
(false, None)
}
-/// Check LLVM installation (macOS only, needed for llvmlite/numba)
-#[cfg(target_os = "macos")]
-fn check_llvm(install_dir: &PathBuf) -> (bool, Option<String>) {
- let llvm_dir = install_dir.join("llvm");
- let llvm_config = llvm_dir.join("bin/llvm-config");
-
- if llvm_config.exists() {
- return (true, Some(llvm_dir.to_string_lossy().to_string()));
- }
-
- (false, None)
-}
-
-#[cfg(not(target_os = "macos"))]
-fn check_llvm(_install_dir: &PathBuf) -> (bool, Option<String>) {
- // LLVM not needed on Windows/Linux for our use case
- (true, Some("Not required".to_string()))
-}
-
-/// Check TA-Lib installation (needed for ta-lib Python wrapper)
-#[cfg(target_os = "macos")]
-fn check_talib(install_dir: &PathBuf) -> (bool, Option<String>) {
- let talib_dir = install_dir.join("ta-lib");
- let talib_lib = talib_dir.join("lib/libta_lib.a");
-
- if talib_lib.exists() {
- return (true, Some(talib_dir.to_string_lossy().to_string()));
- }
-
- (false, None)
-}
-
-#[cfg(not(target_os = "macos"))]
-fn check_talib(_install_dir: &PathBuf) -> (bool, Option<String>) {
- // For Windows/Linux, check if ta-lib headers are available
- // This is a simplified check - may need platform-specific logic
- (true, Some("Check manually".to_string()))
-}
/// Check if Python packages are installed in both venvs
fn check_packages(install_dir: &PathBuf) -> bool {
@@ -582,150 +544,6 @@ async fn install_bun(app: &AppHandle, install_dir: &PathBuf) -> Result<(), Strin
Ok(())
}
-/// Install LLVM (macOS only, needed for llvmlite/numba)
-#[cfg(target_os = "macos")]
-async fn install_llvm(app: &AppHandle, install_dir: &PathBuf) -> Result<(), String> {
- emit_progress(app, "llvm", 0, "Installing LLVM...", false);
-
- let llvm_dir = install_dir.join("llvm");
- std::fs::create_dir_all(&llvm_dir)
- .map_err(|e| format!("Failed to create LLVM dir: {}", e))?;
-
- // Detect architecture
- let arch = std::env::consts::ARCH;
- let (platform, llvm_version) = if arch == "aarch64" {
- ("arm64-apple-darwin22.0", "17.0.6")
- } else {
- ("x86_64-apple-darwin22.0", "17.0.6")
- };
-
- emit_progress(app, "llvm", 20, "Downloading LLVM...", false);
-
- let download_url = format!(
- "https://github.com/llvm/llvm-project/releases/download/llvmorg-{}/clang+llvm-{}-{}.tar.xz",
- llvm_version, llvm_version, platform
- );
- let tar_path = llvm_dir.join("llvm.tar.xz");
-
- let mut cmd = Command::new("curl");
- cmd.args(&["-L", "-o", tar_path.to_str().unwrap(), &download_url]);
- let output = cmd.output().map_err(|e| format!("LLVM download failed: {}", e))?;
- if !output.status.success() {
- return Err(format!("LLVM download failed: {}", String::from_utf8_lossy(&output.stderr)));
- }
-
- eprintln!("[SETUP] LLVM download complete, file size: {} bytes",
- std::fs::metadata(&tar_path).map(|m| m.len()).unwrap_or(0));
-
- emit_progress(app, "llvm", 60, "Extracting LLVM...", false);
-
- // Extract tar.xz
- let mut cmd = Command::new("tar");
- cmd.args(&["-xf", tar_path.to_str().unwrap(), "-C", llvm_dir.to_str().unwrap(), "--strip-components=1"]);
- let output = cmd.output().map_err(|e| format!("LLVM extract failed: {}", e))?;
- if !output.status.success() {
- return Err(format!("LLVM extract failed: {}", String::from_utf8_lossy(&output.stderr)));
- }
-
- let _ = std::fs::remove_file(&tar_path);
-
- emit_progress(app, "llvm", 100, "LLVM installed", false);
- Ok(())
-}
-
-#[cfg(not(target_os = "macos"))]
-async fn install_llvm(_app: &AppHandle, _install_dir: &PathBuf) -> Result<(), String> {
- // LLVM not needed on Windows/Linux
- Ok(())
-}
-
-/// Install TA-Lib (needed for ta-lib Python wrapper)
-#[cfg(target_os = "macos")]
-async fn install_talib(app: &AppHandle, install_dir: &PathBuf) -> Result<(), String> {
- emit_progress(app, "talib", 0, "Installing TA-Lib...", false);
-
- let talib_dir = install_dir.join("ta-lib");
- std::fs::create_dir_all(&talib_dir)
- .map_err(|e| format!("Failed to create TA-Lib dir: {}", e))?;
-
- emit_progress(app, "talib", 20, "Downloading TA-Lib...", false);
-
- // Download TA-Lib source
- let talib_version = "0.4.0";
- let download_url = format!("https://downloads.sourceforge.net/project/ta-lib/ta-lib/{}/ta-lib-{}-src.tar.gz", talib_version, talib_version);
- let tar_path = talib_dir.join("ta-lib.tar.gz");
-
- let mut cmd = Command::new("curl");
- cmd.args(&["-L", "-o", tar_path.to_str().unwrap(), &download_url]);
- let output = cmd.output().map_err(|e| format!("TA-Lib download failed: {}", e))?;
- if !output.status.success() {
- return Err(format!("TA-Lib download failed: {}", String::from_utf8_lossy(&output.stderr)));
- }
-
- eprintln!("[SETUP] TA-Lib download complete, file size: {} bytes",
- std::fs::metadata(&tar_path).map(|m| m.len()).unwrap_or(0));
-
- emit_progress(app, "talib", 40, "Extracting TA-Lib...", false);
-
- // Decompress
- let mut gunzip_cmd = Command::new("gunzip");
- gunzip_cmd.arg(tar_path.to_str().unwrap());
- let output = gunzip_cmd.output().map_err(|e| format!("TA-Lib gunzip failed: {}", e))?;
- if !output.status.success() {
- return Err(format!("TA-Lib gunzip failed: {}", String::from_utf8_lossy(&output.stderr)));
- }
-
- // Extract
- let tar_uncompressed = talib_dir.join("ta-lib.tar");
- let mut cmd = Command::new("tar");
- cmd.args(&["-xf", tar_uncompressed.to_str().unwrap(), "-C", talib_dir.to_str().unwrap(), "--strip-components=1"]);
- let output = cmd.output().map_err(|e| format!("TA-Lib extract failed: {}", e))?;
- if !output.status.success() {
- return Err(format!("TA-Lib extract failed: {}", String::from_utf8_lossy(&output.stderr)));
- }
-
- let _ = std::fs::remove_file(&tar_uncompressed);
-
- emit_progress(app, "talib", 60, "Compiling TA-Lib...", false);
-
- // Configure and compile (install to ta-lib dir)
- let configure_script = talib_dir.join("configure");
- let mut cmd = Command::new(&configure_script);
- cmd.args(&["--prefix", talib_dir.to_str().unwrap()]);
- cmd.current_dir(&talib_dir);
- let output = cmd.output().map_err(|e| format!("TA-Lib configure failed: {}", e))?;
- if !output.status.success() {
- return Err(format!("TA-Lib configure failed: {}", String::from_utf8_lossy(&output.stderr)));
- }
-
- emit_progress(app, "talib", 80, "Building TA-Lib (this may take a few minutes)...", false);
-
- // Make and install
- let mut cmd = Command::new("make");
- cmd.current_dir(&talib_dir);
- let output = cmd.output().map_err(|e| format!("TA-Lib make failed: {}", e))?;
- if !output.status.success() {
- return Err(format!("TA-Lib make failed: {}", String::from_utf8_lossy(&output.stderr)));
- }
-
- let mut cmd = Command::new("make");
- cmd.arg("install");
- cmd.current_dir(&talib_dir);
- let output = cmd.output().map_err(|e| format!("TA-Lib install failed: {}", e))?;
- if !output.status.success() {
- return Err(format!("TA-Lib install failed: {}", String::from_utf8_lossy(&output.stderr)));
- }
-
- emit_progress(app, "talib", 100, "TA-Lib installed", false);
- Ok(())
-}
-
-#[cfg(not(target_os = "macos"))]
-async fn install_talib(_app: &AppHandle, _install_dir: &PathBuf) -> Result<(), String> {
- // For Windows/Linux, TA-Lib needs to be installed manually
- eprintln!("[SETUP] TA-Lib installation on Windows/Linux requires manual setup");
- Ok(())
-}
/// Install UV package manager
async fn install_uv(app: &AppHandle, install_dir: &PathBuf) -> Result<(), String> {
@@ -864,26 +682,6 @@ async fn install_packages_in_venv(
cmd
};
- // On macOS, set LLVM and TA-Lib environment variables for package builds
- #[cfg(target_os = "macos")]
- {
- if let (true, Some(llvm_path)) = check_llvm(install_dir) {
- eprintln!("[SETUP] Setting LLVM environment variables for package build");
- cmd.env("LLVM_CONFIG", format!("{}/bin/llvm-config", llvm_path));
- }
-
- if let (true, Some(talib_path)) = check_talib(install_dir) {
- eprintln!("[SETUP] Setting TA-Lib environment variables for package build");
- cmd.env("TA_INCLUDE_PATH", format!("{}/include", talib_path));
- cmd.env("TA_LIBRARY_PATH", format!("{}/lib", talib_path));
- // Also set compiler flags to help find the headers
- let cflags = format!("-I{}/include", talib_path);
- let ldflags = format!("-L{}/lib", talib_path);
- cmd.env("CFLAGS", &cflags);
- cmd.env("LDFLAGS", &ldflags);
- }
- }
-
cmd.args(&[
"pip", "install",
"--python", venv_python.to_str().unwrap(),
@@ -913,15 +711,8 @@ pub fn check_setup_status(app: AppHandle) -> Result<SetupStatus, String> {
let (python_installed, _) = check_python(&install_dir);
let (bun_installed, _) = check_bun(&install_dir);
- let (llvm_installed, _) = check_llvm(&install_dir);
- let (talib_installed, _) = check_talib(&install_dir);
let packages_installed = check_packages(&install_dir);
- // On macOS, LLVM and TA-Lib are required for full package installation
- #[cfg(target_os = "macos")]
- let needs_setup = !python_installed || !bun_installed || !llvm_installed || !talib_installed || !packages_installed;
-
- #[cfg(not(target_os = "macos"))]
let needs_setup = !python_installed || !bun_installed || !packages_installed;
// Initialize worker pool in background if setup is already complete (non-blocking)
@@ -993,24 +784,6 @@ pub async fn run_setup(app: AppHandle) -> Result<String, String> {
emit_progress(&app, "bun", 100, "Bun already installed", false);
}
- // LLVM (macOS only, needed for llvmlite/numba in financial packages)
- let (llvm_installed, llvm_path) = check_llvm(&install_dir);
- if !llvm_installed {
- install_llvm(&app, &install_dir).await?;
- } else {
- eprintln!("[SETUP] LLVM already installed: {}", llvm_path.unwrap_or_default());
- emit_progress(&app, "llvm", 100, "LLVM already installed", false);
- }
-
- // TA-Lib (needed for ta-lib Python wrapper used by vnpy)
- let (talib_installed, talib_path) = check_talib(&install_dir);
- if !talib_installed {
- install_talib(&app, &install_dir).await?;
- } else {
- eprintln!("[SETUP] TA-Lib already installed: {}", talib_path.unwrap_or_default());
- emit_progress(&app, "talib", 100, "TA-Lib already installed", false);
- }
-
// UV (fast package manager)
install_uv(&app, &install_dir).await?;