Skip to content
Back to search

staggi

Next-generation fiduciary AI desktop workspace for multi-asset valuation, real-time market telemetry, and Model Context Protocol (MCP) tool orchestration.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/vieirinhasantana--staggi/badge.svg)](/listings/vieirinhasantana--staggi)

HTML

<a href="/listings/vieirinhasantana--staggi"><img src="/api/listings/vieirinhasantana--staggi/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

- [Node.js](https://nodejs.org/) (v18+) and [Bun](https://bun.sh/) installed. - [Rust](https://www.rust-lang.org/) (cargo v1.80+). - Platform-specific Tauri build tools (see [Tauri Prerequisites](https://v2.tauri.app/start/prerequisites/)).

1. Clone the Repository

git clone https://github.com/vieirinhasantana/staggi.git
cd staggi

2. Install Frontend Dependencies

bun install

3. Run in Desktop Development Mode

bun run tauri dev

4. Type Check & Production Build

# Type check Svelte 5 Runes and TypeScript
bun run check

# Compile production binary (.dmg / .app / .deb / .msi)
bun run tauri build

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 197 lines
  1. <div align="center">
  2. <img src="static/favicon.png" alt="Staggi Logo" width="96" height="96" style="border-radius: 24px; box-shadow: 0 8px 24px rgba(0,0,0,0.4);" />
  3. # Staggi — AI Wealth Launcher
  4. **The executive desktop copilot and market intelligence engine built for investment advisors, family offices, and wealth managers.**
  5. [![Tauri v2](https://img.shields.io/badge/Tauri-v2.0-24C8D8?style=for-the-badge&logo=tauri&logoColor=white)](https://v2.tauri.app/)
  6. [![Svelte 5](https://img.shields.io/badge/Svelte-5.0_(Runes)-FF3E00?style=for-the-badge&logo=svelte&logoColor=white)](https://svelte.dev/)
  7. [![Rust](https://img.shields.io/badge/Rust-1.80+-DEA584?style=for-the-badge&logo=rust&logoColor=black)](https://www.rust-lang.org/)
  8. [![Tailwind CSS v4](https://img.shields.io/badge/Tailwind_CSS-v4.0-38B2AC?style=for-the-badge&logo=tailwind-css&logoColor=white)](https://tailwindcss.com/)
  9. [![Bun](https://img.shields.io/badge/Runtime-Bun-FBF0DF?style=for-the-badge&logo=bun&logoColor=black)](https://bun.sh/)
  10. [![License](https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge)](LICENSE)
  11. <br/>
  12. <p align="center">
  13. <a href="#-overview">Overview</a> •
  14. <a href="#-visual-showcase">Showcase</a> •
  15. <a href="#-key-features">Key Features</a> •
  16. <a href="#-security--zero-leak-architecture">Security & Zero-Leak</a> •
  17. <a href="#-installation--running">Installation</a> •
  18. <a href="#-llms--autonomous-agents-guide">LLMs Guide</a>
  19. </p>
  20. ---
  21. </div>
  22. <br/>
  23. ## 📸 Visual Showcase
  24. <div align="center">
  25. <img src="docs/images/staggi-preview.png" alt="Staggi Executive Interface" width="920" style="border-radius: 16px; border: 1px solid rgba(255,255,255,0.12); box-shadow: 0 16px 40px rgba(0,0,0,0.6);" />
  26. </div>
  27. <br/>
  28. <div align="center" style="display: flex; gap: 16px; justify-content: center; flex-wrap: wrap;">
  29. <img src="docs/images/staggi-ui-settings.png" alt="Staggi Multi-Provider AI Settings" width="450" style="border-radius: 12px; border: 1px solid rgba(255,255,255,0.08);" />
  30. <img src="docs/images/staggi-ui-mcps.png" alt="Staggi MCP Servers & Skills Ecosystem" width="450" style="border-radius: 12px; border: 1px solid rgba(255,255,255,0.08);" />
  31. </div>
  32. ---
  33. ## 💎 Overview
  34. **Staggi** is an ultra-fast, native desktop application (crafted in **Rust** and **Svelte 5 Runes**) designed specifically for the analytical workflow of wealth advisors, capital allocators, and fiduciary portfolio managers.
  35. It unifies:
  36. 1. **Multi-LLM Flagship Engine**: Seamless native integration with Google Gemini (2.0 Flash, Flash Thinking), OpenAI (GPT-4o, o1, o3-mini), and Anthropic Claude 3.7 Sonnet with Extended Thinking.
  37. 2. **Real-Time Official Market Data**: Direct integration with B3, NYSE, Nasdaq, and global exchanges via a native Rust backend (zero fragile scraping, zero mock data).
  38. 3. **Model Context Protocol (MCP)**: Native orchestration of local and remote MCP servers for balance sheet breakdowns, ETF holdings, fixed income debt schedules, and insider transaction tracking.
  39. 4. **Specialized Analytical Skills (`SKILL.md`)**: Instant invocation of institutional financial frameworks such as `/valuation` (Graham, Bazin, Multiples), `/dividends`, `/screening`, and `/fixed-income` directly from the Spotlight bar (`Ctrl+Space` / `Cmd+Space`).
  40. 5. **Background Automations**: Scheduled routines that quietly monitor portfolios, corporate disclosures, and dividend announcements, delivering proactive executive briefs.
  41. ---
  42. ## ⚡ Key Features
  43. - 🧠 **Contextual "Thinking..." Indicator with Pulsing Brain**: Transparent real-time feedback displaying which tool, MCP server, or skill is actively running (`Thinking... [Yahoo Finance Market Data]`, `Thinking... [Skill: Valuation]`, etc.).
  44. - 🌊 **Smooth 60fps Progressive Streaming**: Natural token-by-token response rendering with an animated pulsing cursor `▌`, eliminating freezes and abrupt text dumps.
  45. - 🎯 **Configurable Reasoning Enforcement Levels**:
  46. - `LOW`: Fast, synthesized responses with minimal latency.
  47. - `MEDIUM`: Balanced fiduciary standard.
  48. - `HIGH`: Maximum cognitive rigor featuring step-by-step mathematical audits, formula derivation, and exhaustive multi-factor tables (`reasoning_effort` for OpenAI and `thinking` budget for Anthropic).
  49. - 🧩 **Rich Interactive Financial Cards**:
  50. - `AssetQuoteCard`: Real-time stock prices, intraday spread, and trading volume.
  51. - `ValuationProjectionCard`: Graham Formula, Bazin Dividend Ceiling Price (6% DY threshold), and margin of safety.
  52. - `AssetDividendsCard`: Declared payouts, historical 12-month Dividend Yield, and ex-dividend dates.
  53. - `CorporateEventsCard`: Official CVM/SEC filings structured by regulatory materiality and impact.
  54. - `ComparisonTableCard`: Side-by-side multiple comparison across sector peers.
  55. - `AssetProfileCard`: Complete institutional profile, asset class, issuer, benchmark, and administration metrics.
  56. - 🔔 **Floating Toast Notification System**: Immediate contextual feedback in the upper viewport with auto-dismiss, replacing cumbersome bottom banners.
  57. - 🚀 **Global Spotlight Launcher**: Summon Staggi from anywhere on your desktop with a global keyboard shortcut (`Ctrl+Space` / `Cmd+Space`).
  58. ---
  59. ## 🛡️ Security & Zero-Leak Architecture (Strict Fiduciary Privacy)
  60. > [!IMPORTANT]
  61. > **Complete Privacy and Direct Connection (Zero-Telemetry):**
  62. > Staggi is engineered strictly under fiduciary security standards:
  63. 1. **100% Local Sandboxed Storage**:
  64. - Your API keys (`Google AI Studio`, `OpenAI Platform`, `Anthropic Console`) and chat history remain **exclusively on your local machine** within Tauri's isolated OS sandbox.
  65. - **Zero intermediary proxy servers**: All AI and market requests originate from your local desktop binary directly to official provider endpoints (`api.openai.com`, `generativelanguage.googleapis.com`, `api.anthropic.com`).
  66. 2. **Clean Git Repository Policy**:
  67. - No API keys, tokens, or private secrets are ever committed into the codebase.
  68. - The `.gitignore` file strictly blocks environment configs (`.env`, `.env.*`), cryptographic keys (`*.pem`, `*.key`), and build artifacts.
  69. 3. **Secure Native Bridge**:
  70. - External HTTPS requests are handled by the native Rust backend ([src-tauri/src/lib.rs](src-tauri/src/lib.rs)), bypassing webview CORS limitations and preventing token exposure in browser script runtimes.
  71. ---
  72. ## 🏗️ Project Structure (Clean Architecture)
  73. ```
  74. staggi/
  75. ├── LLMS.md # Canonical guide for AI coding assistants and LLMs
  76. ├── ARCHITECTURE.md # In-depth architectural diagrams and data flows
  77. │
  78. ├── src-tauri/ # Native Rust Backend (Tauri 2.0 Core)
  79. │ ├── src/lib.rs # IPC Commands (ask_ai, test_ai_connection, fetch_yahoo_data...)
  80. │ └── Cargo.toml # Rust Dependencies (reqwest, serde, tauri)
  81. │
  82. └── src/ # Frontend (SvelteKit + Svelte 5 Runes)
  83. ├── routes/ # Presentation Layer & Routes
  84. │ ├── +layout.svelte # Global shell with ToastContainer
  85. │ └── +page.svelte # Core Workspace: Chat, Spotlight, Session Drawer
  86. │
  87. └── lib/
  88. ├── types/domain/ # Domain Layer: Strict typing for AI, Financial, MCPs, Tasks
  89. ├── services/ # Application Layer: Svelte 5 reactive stores & orchestrators
  90. ├── utils/ # Utility Layer: Formatters, UI helpers, tailwind-merge
  91. └── components/ # UI Layer: Modular Svelte 5 components
  92. ├── settings/ # Settings Tabs (AI, MCPs, Skills, Tasks)
  93. └── cards/ # Dynamic Financial Response Cards (Valuation, Quotes, Dividends...)
  94. ```
  95. ---
  96. ## 🚀 Installation & Running
  97. ### Prerequisites
  98. - [Node.js](https://nodejs.org/) (v18+) and [Bun](https://bun.sh/) installed.
  99. - [Rust](https://www.rust-lang.org/) (cargo v1.80+).
  100. - Platform-specific Tauri build tools (see [Tauri Prerequisites](https://v2.tauri.app/start/prerequisites/)).
  101. ### 1. Clone the Repository
  102. ```bash
  103. git clone https://github.com/vieirinhasantana/staggi.git
  104. cd staggi
  105. ```
  106. ### 2. Install Frontend Dependencies
  107. ```bash
  108. bun install
  109. ```
  110. ### 3. Run in Desktop Development Mode
  111. ```bash
  112. bun run tauri dev
  113. ```
  114. ### 4. Type Check & Production Build
  115. ```bash
  116. # Type check Svelte 5 Runes and TypeScript
  117. bun run check
  118. # Compile production binary (.dmg / .app / .deb / .msi)
  119. bun run tauri build
  120. ```
  121. ---
  122. ## 📦 Releases & Versioning
  123. Staggi adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). For a full history of updates, releases, and architectural improvements, consult the **[CHANGELOG.md](CHANGELOG.md)**.
  124. Platform desktop bundles (.dmg, .app, .deb, .AppImage, .msi) are available under the **[Releases](https://github.com/vieirinhasantana/staggi/releases)** section.
  125. ---
  126. ## 👥 Contributors & Community
  127. Contributions from the open-source and financial engineering community are warmly welcomed!
  128. - **How to Contribute**: Please review **[CONTRIBUTING.md](CONTRIBUTING.md)** for our development workflow, Svelte 5 Rune conventions, and PR checklist.
  129. - **Security & Privacy**: Consult **[SECURITY.md](SECURITY.md)** for vulnerability reporting procedures and local-only secret protection.
  130. - **Issue Tracking**: Submit bug reports and feature proposals using our interactive [Issue Templates](https://github.com/vieirinhasantana/staggi/issues).
  131. <p align="center">
  132. <a href="https://github.com/vieirinhasantana/staggi/graphs/contributors">
  133. <img src="https://contrib.rocks/image?repo=vieirinhasantana/staggi" alt="Staggi Contributors" />
  134. </a>
  135. </p>
  136. ---
  137. ## 🤖 LLMs & Autonomous Agents Guide
  138. For AI coding agents and autonomous workflows exploring or modifying Staggi:
  139. - Read **[LLMS.md](LLMS.md)** at the root of the repository for full structural mapping, domain contracts, and coding rules.
  140. - Review **[ARCHITECTURE.md](ARCHITECTURE.md)** for sequence diagrams, concentric layer constraints, and clean design patterns.
  141. ---
  142. ## 📄 License
  143. Distributed under the **MIT** License. See [LICENSE](LICENSE) for details.
  144. <div align="center">
  145. <sub>Engineered with analytical rigor and fiduciary-grade privacy.</sub>
  146. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.