Skip to main content

⚡ Sandevistan

AI-augmented Apple security research toolkit

Sandevistan augments your security research with AI-powered tools for analyzing Apple crash reports, tracking security updates, and more.

sandy analyze crash.ips      # AI-powered crash analysis
sandy scrape                 # Fetch Apple security updates
# ✨ Powered by Google Gemini Flash

🎯 Why Sandevistan?

Like the Cyberpunk cyberware it's named after, Sandevistan augments your capabilities—letting you process security data at machine speed.

Challenge How Sandevistan Helps
😵 Crash logs are cryptic 📖 AI translates IPS files to plain English
⏰ Tracking updates is tedious 🔄 Auto-scrape Apple security advisories
🤔 CVE details scattered 📊 Structured data export (JSON/CSV/SQLite)
📚 Need deep Apple internals knowledge 🤖 AI handles the technical analysis

🚀 Quick Start

📦 Installation

macOS (Homebrew):

brew tap Dil4rd/sandevistan
brew install sandevistan

Cross-platform (uvx - recommended):

uvx sandevistan  # or 'sandy' for short

Alternative (pipx):

pipx install sandevistan

🔑 Setup (one-time)

sandy config --api-key YOUR_GOOGLE_API_KEY

🔗 Get your free API key: Google AI Studio


🔧 Features

Note: Both sandevistan and sandy commands work identically. Examples below use sandy for brevity.

🧠 Crash Analysis

Analyze Apple IPS crash files with AI-powered explanations.

# Single file
sandy analyze crash.ips

# Entire folder
sandy analyze ~/Library/Logs/DiagnosticReports/

When multiple files are found, you'll get an interactive menu:

Found 3 IPS files in ./crashes:
  [0] All files
  [1] AppCrash_2024-01-15.ips
  [2] KernelPanic_2024-01-16.ips
  [3] SegFault_2024-01-17.ips

Select files to analyze (e.g., "1,3" or "0" for all): _

What you get:

  • ✅ What crashed — Process, thread, and component that failed
  • ✅ Why it crashed — Root cause in plain English
  • ✅ Key details — Exception types, addresses, and code symbols

🔍 Security Updates Scraper

Scrape Apple's security updates and CVE data into structured formats.

# Scrape to all formats (JSON, CSV, SQLite)
sandy scrape

# Specific format(s)
sandy scrape -f json
sandy scrape -f json -f csv

# Custom output filename
sandy scrape -o security_updates

# Fast mode (skip detailed CVE scraping)
sandy scrape --skip-advisories

Output includes:

  • 📋 Security update metadata (date, OS, version, URL)
  • 🐛 CVE entries with descriptions
  • 🔗 Links to full advisories

⚙️ Configuration

sandy config --show                # 📋 View current settings
sandy config --path                # 📂 Show config location
sandy config --api-key YOUR_KEY    # 🔐 Update API key
sandy config --model gemini-2.0    # 🤖 Change AI model
sandy config --delay 2.0           # ⏱️ Set scraper rate limit

📝 Example Output

Crash Analysis

Analyzing file: MyApp_2024-01-15.ips
Using model: gemini-2.0-flash-exp
────────────────────────────────────────────────────────────────────────────────

**What crashed:** MyApp (process) crashed in the main thread

**Why it crashed:** Null pointer dereference - The app attempted to access
memory at address 0x0, which is not a valid memory location.

**Key technical details:**
- Exception Type: EXC_BAD_ACCESS (SIGSEGV)
- Exception Codes: KERN_INVALID_ADDRESS at 0x0000000000000000
- Crashed Thread: 0 (Main thread)
- Relevant Frame: MyApp`-[MyViewController buttonTapped:] + 42

Security Updates Scrape

Scraping Apple security updates...
Found 156 security updates
Fetching advisory details... [████████████████████] 100%
Exported to: security_updates.json, security_updates.csv, security_updates.db

🛠️ Development

Local development

# Clone the repo
git clone https://github.com/Dil4rd/sandevistan.git
cd sandevistan

# Run without installation
uvx --from . sandy --help

# Install in editable mode
uv pip install -e .

Requirements

  • 🐍 Python 3.11+
  • 🔑 Google API key (free tier available)
  • 📦 uv package manager (install here)

🏗️ Architecture

Built with modern Python tools for speed and reliability:

  • 🧠 AI Engine: Google Gemini Flash (fast, accurate analysis)
  • 🔄 Workflow: LangGraph (structured multi-step pipelines)
  • ⚙️ CLI: Click (user-friendly command interface)
  • 📦 Package Manager: uv (blazing fast dependency resolution)

🗺️ Roadmap

Future augmentations planned:

  • IPS explannation caching for efficient token reuse
  • IPS deduplication
  • Incremental security updates scrape
  • Advanced analytics of security udpates

🤝 Contributing

Found a bug? Have an idea? Contributions are welcome!

  1. Fork the repo
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📄 License

MIT License - see LICENSE file for details


🙏 Acknowledgments


⚡ Augment your Apple security research

Get Started • Report Bug • Request Feature

Metadata

Release files for sandevistan 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sandevistan 0.3.0
File Size Uploaded Provenance Actions
sandevistan-0.3.0.tar.gz 17.4 kB With provenance Details for sandevistan-0.3.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for sandevistan 0.3.0
File Interpreter ABI Platform Actions
sandevistan-0.3.0-py3-none-any.whl Python 3 none any Details for sandevistan-0.3.0-py3-none-any.whl

Total release size: 32.3 kB

Release files / sandevistan-0.3.0.tar.gz

Download URL sandevistan-0.3.0.tar.gz
Size 17.4 kB
Tags Source
SHA-256 checksum
How to use checksums
540b751ec9565608ea561bc0615393f8d82631d3efad99e89624d40bbb365cce
BLAKE2b-256 checksum
How to use checksums
24151c1dfa87c6acf5607f44295e9ee672f78dec709fdcffacdc89d8ac68d267
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jan 16, 2026.

Transparency log

Release files / sandevistan-0.3.0-py3-none-any.whl

Download URL sandevistan-0.3.0-py3-none-any.whl
Size 14.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2ea17592617a64397dcd19eccb4072f3fc0abc54a4114f8697fefb2555d717d8
BLAKE2b-256 checksum
How to use checksums
72197b38b6b67225526459c97a7be1c33b8586d450980cc46f0b5ad319cf85f0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jan 16, 2026.

Transparency log

Security for sandevistan 0.3.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for sandevistan-0.3.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jan 16, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page