AI-powered mod compatibility checker for Bethesda games.

# Clone the repository
git clone https://github.com/SamsonProject/SkyModderAI.git
cd SkyModderAI

# Install dependencies
pip install -r requirements.txt

# Run the application
python app.py

Then open http://localhost:5000

• Mod Manager Integration — MO2, Vortex, Wabbajack plugins
• Real-time Collaboration — Work on mod lists with friends
• Advanced Analytics — Track mod performance over time
• Mobile App — Check your mod list on the go

OpenCLAW is your browser-based automated modding assistant. It learns from your modding sessions, proposes improvements, and guides implementation — all safely sandboxed.

1. Analyzes your current mod conflicts and performance
2. Researches solutions from Nexus, Reddit, GitHub
3. Proposes a 5-phase improvement plan
4. Executes changes in a sandbox (with your permission)
5. Learns from your feedback to improve future suggestions

1. Navigate to the site
2. Click "OpenCLAW" in the main navigation
3. Grant permissions (8 granular scopes available)
4. Propose a plan (select goal, playstyle, game)
5. Execute and enjoy!

URL: /api/v1/openclaw/

• ✅ Permission-based access (you control what it can do)
• ✅ Sandbox isolation (can't modify system files)
• ✅ Hard-coded denied operations (BIOS, kernel, drivers blocked)
• ✅ File extension whitelist (only safe types allowed)
• ✅ Path traversal protection (no escapes from sandbox)
• ✅ Audit logging (all operations tracked)

1. Deterministic First, AI Second — Rules don't hallucinate (90/10 split)
2. Privacy by Default — No PII in telemetry, local-first storage
3. Community-Driven — Crowdsourced compatibility data
4. Transparent — Show exactly why conflicts are flagged
5. Self-Limiting — Success means the problem is solved

• Backend: Python 3.11, Flask
• Database: PostgreSQL (production), SQLite (development)
• Cache: Redis (production), in-memory (development)
• Frontend: Vanilla JS, no framework
• Testing: pytest, hypothesis, locust

SkyModderAI/
├── blueprints/          # Flask route blueprints
│   ├── api.py           # REST API
│   ├── analysis.py      # Analysis routes
│   ├── auth.py          # Authentication
│   ├── community.py     # Community features
│   ├── openclaw.py      # OpenCLAW automation
│   └── ...
├── services/            # Business logic
├── repositories/        # Data access layer
├── templates/           # HTML templates
├── static/              # Frontend assets
├── tests/               # Test suite
└── docs/                # Documentation

See ARCHITECTURE.md for full system design.

• Quickstart Guides — MO2, Vortex, Wabbajack integration
• Modding Glossary — ESP vs ESM, load order, conflicts
• Common Conflicts — Known issues with popular mods

• Architecture — System design, data flow, storage strategy
• Build Guide — Setup, installation, deployment
• Data Models — Database schema and ORM
• Security — Security policies and best practices

• User Guide — How to use OpenCLAW
• Technical Plan — Enhancement roadmap

• Research Summary — Comprehensive research integration
• Philosophy — Core principles
• Samson Manifesto — Long-term vision

Full documentation index: docs/README.md

# Run all tests
pytest

# Run with coverage
pytest --cov=. --cov-report=html

# Run specific test suite
pytest tests/test_conflict_detector.py -v

# Run OpenCLAW tests
pytest tests/test_openclaw.py -v

Test Coverage: 80%+ required (enforced in CI)

1. Code — New features, bug fixes, performance improvements
2. Documentation — Guides, tutorials, translations
3. Testing — Bug reports, compatibility data
4. Community — Help others, share builds, vote on features

git clone https://github.com/SamsonProject/SkyModderAI.git
cd SkyModderAI
python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements-dev.txt
pre-commit install

See CONTRIBUTING.md for detailed guidelines.

• UI improvements for compatibility database
• Load order share frontend
• Mod author verification flow
• SEO landing pages for mod pairs
• Test coverage improvements

• Feature usage (anonymized)
• Compatibility patterns (aggregated)
• Session continuity (local UUID)

• Personal identifiers (email, IP — hashed only)
• Full mod lists (unless explicitly shared)
• Session duration (we don't optimize for addiction)

• Export your data: GET /api/samson/telemetry/export
• Delete your data: POST /api/samson/telemetry/delete
• Opt-out: Set SAMSON_TELEMETRY_ENABLED=false

See SECURITY.md for full security policy.

• Redis caching (production)
• LOOT data cached for 7 days
• In-memory fallback (development)
• Rate limiting (default: 100/minute)
• Connection pooling

See docs/scaling_guide.md for detailed scaling strategies.

• OpenCLAW browser integration
• Codebase cleanup & consistency fixes
• Compatibility database UI
• Mod author verification program

• 10K active users
• Mod manager plugins (MO2, Vortex)
• Real-time collaboration
• Mobile-responsive UI

• Phase II deployment (ecological beachhead)
• Worker ownership pilot (first robot equity)
• Ethical AGI research (cognitive architecture)

• Email: [email protected]
• GitHub: Issues
• Reddit: r/skyrimmods (tag: [SkyModderAI])

• Nexus Mods: Mod compatibility data
• LOOT: Load Order Optimization Tool
• UESP: Unofficial Elder Scrolls Pages

MIT License — Free to use, modify, and distribute.

Copyright (c) 2026 SkyModderAI

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

See LICENSE for full terms.

• LOOT Team — Load order rules and masterlist data
• Nexus Mods — Mod hosting and API
• UESP — Game mechanics documentation
• xEdit Team — Mod cleaning tools
• Modding Community — Compatibility reports and feedback

SkyModderAI is 100% free + donations. No paywalls, no premium tiers, no bullshit.

If it saved your load order, consider buying us a mead. If not, no hard feelings — use it, leave it, come back when you need it.

Free forever. Open source. Privacy-first.

Last Updated: February 21, 2026
Version: 1.0.0 (Beta)