Lightweight desktop application for managing and running AI agents locally

Version License Node

• 🚀 Run agents locally - Execute AI agents on your machine
• ✏️ Edit configurations - Customize agent settings and behavior
• 📋 Manage agents - List, create, and organize your agents
• 🔒 Secure - Context isolation and validated inputs
• 🌐 Cross-platform - Linux, macOS, and Windows support

• Framework: Electron 33+ • React 18+
• Language: TypeScript 5.3+ (strict mode)
• Build: Vite 6+ • electron-builder
• Validation: Zod
• Testing: Jest 30+ • Playwright
• State: Zustand
• Styling: Tailwind CSS 4+

• Node.js ≥ 20.0.0
• npm ≥ 10.0.0

# Install dependencies
npm install
# Start development (Electron)
npm run dev
# Start development (Web)
npm run dev:web
# Build for production
npm run build
# Package for distribution
npm run package -w @agentage/electron

packages/
 core/ # Core business logic
 electron/ # Electron main + preload
 frontend/ # React UI (renderer)
 server/ # Backend server
 shared/ # Shared types & schemas

# Type checking
npm run type-check
# Linting
npm run lint
npm run lint:fix
# Testing
npm run test
npm run test:coverage
npm run test:e2e
# Full verification
npm run verify

# Build all packages
npm run build
# Package for current platform
npm run package -w @agentage/electron

Artifacts are published to GitHub Releases on tag push.

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

See LICENSE file for details.

Made with ❤️ by Agentage