⚡ 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
sandevistanandsandycommands work identically. Examples below usesandyfor 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)
- 📦
uvpackage 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!
- Fork the repo
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
📄 License
MIT License - see LICENSE file for details
🙏 Acknowledgments
- Powered by Google Gemini
- Built with LangGraph
- Package management by uv
⚡ Augment your Apple security research
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.