# Majordome

Agentic Windows application for intelligent file organization and automated PC maintenance

Features • Installation • Development • Documentation

• Safe removal of temporary files
• Application cache cleaning
• Recycle bin management
• System file protection

• Sort downloads by type
• Organize photos by date
• Document classification
• Habit-based suggestions

• Natural language chat with Ollama
• Intelligent suggestions
• Learns your preferences
• Works 100% offline

• Manual, semi-auto, or automatic mode
• Confirmations for risky actions
• Scheduled tasks
• Preventive notifications

Visit the Releases page to download:

• Majordome-Setup-x.x.x.exe - Windows Installer
• Majordome-Portable-x.x.x.exe - Portable version

For advanced AI features, install Ollama:

# Via winget
winget install Ollama.Ollama

# Download the model
ollama pull qwen2.5-coder:1.5b

• Node.js 20+
• pnpm 9+
• Git

# Clone the repo
git clone https://github.com/Krigsexe/Majordome.git
cd Majordome

# Install dependencies
pnpm install

# Configure the database
pnpm db:generate
pnpm db:push

# Start development
pnpm dev

majordome/
├── apps/
│   ├── desktop/          # Electron + React + Vite
│   └── backend/          # NestJS local API
├── packages/
│   └── shared/           # Shared types and utilities
├── docs/                 # Documentation
├── scripts/              # Installation scripts
└── .github/              # CI/CD workflows

• User Guide - How to use Majordome
• Architecture - Technical documentation
• Changelog - Version history
• Contributing - Contribution guide

• 100% Local: All data stays on your PC
• No telemetry: No data collection
• Open Source: Verifiable code
• Encryption: API keys stored with AES-256
• Sandbox: Electron isolation enabled

• Smart system cleanup
• Automatic file organization
• AI assistant with Ollama
• Learning system
• Auto-update
• Full multi-language support
• Advanced scheduled tasks
• Duplicate detection
• Cloud integration (OneDrive, GDrive)

Contributions are welcome! See CONTRIBUTING.md for details.

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

Distributed under the MIT License. See LICENSE for more information.

Made with care by Krigs.exe