Skip to content

Latest commit

Β 

History

184 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

SpanInsight

A high-performance, cloud-powered data intelligence platform for smart data collection, Colab GPU/TPU analysis, and autonomous reporting.

Google Play Store Download APK Download Windows Download Linux Built with Flet Python Google Colab


Download

Platform Download Notes
πŸ€– Android (Google Play) Play Store Recommended for Android phone and tablet users
πŸͺŸ Windows Windows Release Automated standalone setup installer with desktop shortcut integration
🐧 Linux (Debian/Ubuntu) Linux DEB Desktop package tailored for Ubuntu, Debian, Linux Mint & Pop!_OS
🎩 Linux (Fedora/RHEL) Linux RPM Desktop package tailored for Fedora, openSUSE, RHEL & CentOS
πŸ“¦ Linux (Universal Portable) Linux TAR.GZ Universal standalone portable archive for Arch, Alpine, Steam Deck & all distros

Android Architecture Build Splits (Direct APK)

Variant Download Notes
πŸ“± ARM64 (most phones) spaninsight-arm64-v8a.apk Modern 64-bit Android devices
πŸ“± ARMv7 (older phones) spaninsight-armeabi-v7a.apk Legacy 32-bit Android devices
πŸ’» x86_64 (emulators) spaninsight-x86_64.apk Chromebooks & Android emulators

Core Capabilities

Capability Description
Google Colab Cloud Execution Heavy computations, machine learning models, and complex datasets execute on Google Colab GPUs and TPUs with zero battery drain on your phone.
Autonomous Autopilot Multi-pass self-directed analytical engine that formulates hypotheses, executes code, generates plots, and compiles full analytical reports with expandable thought accordions.
Self-Healing Code Execution Real-time Python traceback inspection: if code encounters an error during execution, AI automatically analyzes the traceback, repairs the code, and retries seamlessly.
Jupyter (.ipynb) Session Export Export your entire notebook session with all code cells, narrative explanations, and execution outputs directly to standard .ipynb files for VS Code or Google Colab.
Expert Code Mode Expandable VS Code-style terminal for direct Python execution. Write and run custom code with full kernel control at zero credit cost.
Interactive Colab File Explorer Complete cloud file manager with breadcrumb navigation, folder zip downloads, upload pipelines, and 1-tap dataset loading into Analysis.
Smart Voice Surveys Natural language survey generation (Voice or Text) with instant mobile preview, cloud responses tracking, and CSV export protected by Cloudflare Turnstile anti-bot verification.
Rich Report Editor & Live Web Sharing Reorderable narrative blocks, interactive metrics, chart visualizers, and AI executive summary polishing with live public web sharing on reports.spaninsight.com.

Screenshots

Widescreen & Tablet Experience

Workspace Home Screen AI Autopilot Engine
Workspace Home Screen: seamlessly collaborate and organize project files Autonomous AI Autopilot: multi-pass local analysis orchestration for report generation

Mobile Experience & AdMob Rewards

Home Dashboard AdMob & Credits
Home Dashboard: dark theme optimized for local secure workspace sync AdMob & Rewards: watch buffered interstitial ads to top-up daily free credits

Smart Survey Builder & Bot-Protected Forms

Smart Survey Builder Public Mobile Survey View Responses Dashboard
Smart Survey Builder: generate forms from voice or text prompts Public Web Survey: responsive client interface for fast data collection Live Responses: track user feedback in real time with quick-actions

Interactive Visual Analysis & Live Reports

Interactive Data Analysis Interactive Shared Reports
Local Data Analysis: visual charts, tables, and sandboxed execution blocks Interactive Shared Reports: public-facing web insights hosted on reports.spaninsight.com

Document & Presentation Export

PDF Print Preview PowerPoint Export
Export to PDF: native layout engine with print preview controls PowerPoint Slide Generator: export report structures into PPT format

Features

  • Google Colab Cloud Integration: Provision and execute Python workloads on remote Google Colab VMs (CPU, T4 GPU, TPU v5e/v6e) with real-time ANSI terminal output streaming.
  • Transparent Autopilot Reasoning: Inspect step-by-step thinking in expandable thought accordions before code execution runs.
  • Autonomous Self-Healing: Automatically catches runtime Python exceptions, extracts error context, prompts the AI repair pipeline, and heals code seamlessly.
  • Jupyter (.ipynb) Interoperability: Export notebooks directly to .ipynb format for instant sharing across VS Code, JupyterLab, or Colab.
  • Expert Code Mode: Write, inspect, modify, and execute Python code manually with zero credit consumption.
  • Smart Surveys & Turnstile Bot Shield: Voice-driven survey creation with Cloudflare Turnstile anti-bot verification and 1-tap DataFrame import.
  • Live Web Report Publishing: Publish interactive visual reports to reports.spaninsight.com with responsive cards, metrics, and print-ready PDF export.
  • Flet 0.86 Reactive Architecture: Smooth UI animations, adaptive light/dark theming, and responsive layouts across mobile, tablet, and desktop screens.
  • 100% Tested Codebase: Full test coverage with strict linting and formatting compliance (pytest + ruff).

Architecture

Layer Technology Purpose
Frontend UI Flet (Python on Flutter) Cross-platform reactive client with dark/light theming, thought accordions, and chart rendering
Cloud Runtime Google Colab VM (/content) Remote high-performance Python data science kernel (pandas, numpy, scikit-learn, PyTorch, TF)
AI Edge Gateway Cloudflare Worker (api.spaninsight.com) Multi-model AI orchestration, prompt compression, and code generation routing
Survey Database Cloudflare D1 Secure, encrypted relational storage for public survey definitions and response capturing
Report Hosting Cloudflare R2 (reports.spaninsight.com) Ephemeral public web report hosting with responsive HTML/CSS/JS rendering
Local Storage Platform SharedPreferences / Local JSON Client-side OAuth tokens, project state persistence, and hardware preferences

Visual Flow

flowchart TD
    subgraph APP ["πŸ“± SpanInsight Client (Flet Reactive UI)"]
        Onboard["πŸš€ Onboarding"]
        Home["🏠 Home Dashboard"]
        Analysis["⚑ Analysis & Autopilot"]
        Files["πŸ“ Colab File Manager"]
        Forms["πŸ“‹ Smart Surveys"]
        Reports["πŸ“Š Analytical Reports"]
        Settings["βš™οΈ Preferences & Auth"]
    end

    subgraph COLAB ["☁️ Google Colab Cloud Runtime (V2)"]
        VM["πŸ–₯️ VM (CPU / T4 GPU / TPU)"]
        Env["πŸ“¦ Full Python Data Science Stack\n(pandas, scikit-learn, TensorFlow, PyTorch)"]
        POSIX["πŸ—‚οΈ /content/ Workspace & Datasets"]
        VM --- Env
        VM --- POSIX
    end

    subgraph GATEWAY ["πŸ”’ Edge Gateway & Cloud Services"]
        AI["πŸ€– Multi-Model AI Orchestrator"]
        D1["πŸ’Ύ Form Submissions Database"]
        R2["🌐 Ephemeral Report Sharing (7-day lifecycle)"]
    end

    Analysis <==>|Jupyter Protocol / WebSocket| VM
    Files <==>|Direct POSIX File Transfer| POSIX
    Analysis <-->|Prompts & Error Auto-Healing| AI
    Forms <-->|Publish & Submissions| D1
    Reports <-->|Web Share URL| R2
    Home --> Analysis
Loading

Credit System

Action Credits Notes
AI Suggestion 1 Quick analytical queries and column summaries
Custom Prompt / Voice 3 Natural language prompt code generation
Autopilot (Full Report) 15 Multi-step end-to-end hypothesis and report generation
Daily Allowance 50 FREE Automatically resets every 24 hours
Manual Python Code Mode FREE Unlimited code writing and execution via Expert Terminal

Testing & Quality Assurance

SpanInsight features a 100% passing test suite across all services, core modules, and screen workflows:

# Run unit and integration tests
uv run pytest

# Check formatting and linting
uv run ruff check
uv run ruff format

Privacy & Security

SpanInsight is built with a strict Privacy-First architecture:

  1. Direct Cloud VM Routing: When connected to Google Colab, code execution and data processing run directly in your private Colab sandbox. No third-party servers intermediate your raw dataset files.
  2. Encrypted Gateway Transit: All AI prompts sent to the gateway are encrypted via TLS 1.3 with cryptographic client challenge headers.
  3. Turnstile Bot Shield: Public survey forms on forms.spaninsight.com require non-intrusive Cloudflare Turnstile human verification.
  4. Data Sovereignty: Exported notebooks (.ipynb), CSV responses, and PDF reports reside 100% on your local device.

Legal Disclaimer

SpanInsight is an independent application and is not affiliated with, authorized, maintained, sponsored, or endorsed by Google LLC, Google Colaboratory, or any of their affiliates.

Users are responsible for complying with Google Colab's Terms of Use, resource usage guidelines, and applicable data privacy regulations.


Β© 2025–2026 Kiri Research Labs

About

Privacy-first AI data analysis app for CSV, Excel, SQL, JSON, etc. with real-time surveys, live reports, voice input, PDF/PPT export, and cross-platform support.

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages