https://github.com/agentage/desktop
Electron desktop app for Agentage — local UI for running and managing agents
https://github.com/agentage/desktop
Last synced: 4 months ago
JSON representation
Electron desktop app for Agentage — local UI for running and managing agents
- Host: GitHub
- URL: https://github.com/agentage/desktop
- Owner: agentage
- Created: 2025-12-03T22:00:01.000Z (6 months ago)
- Default Branch: master
- Last Pushed: 2026-01-17T22:18:48.000Z (5 months ago)
- Last Synced: 2026-01-18T07:58:40.840Z (5 months ago)
- Language: TypeScript
- Size: 1.24 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Agentage Desktop
> Lightweight desktop application for managing and running AI agents locally
[](https://github.com/agentage/desktop/releases)
[](LICENSE)
[](package.json)
## ✨ Features
- 🚀 **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
## 🛠️ Tech Stack
- **Framework**: [Electron](https://electronjs.org/) 33+ • [React](https://react.dev/) 18+
- **Language**: [TypeScript](https://typescriptlang.org/) 5.3+ (strict mode)
- **Build**: [Vite](https://vite.dev/) 6+ • [electron-builder](https://electron.build/)
- **Validation**: [Zod](https://zod.dev/)
- **Testing**: [Jest](https://jestjs.io/) 30+ • [Playwright](https://playwright.dev/)
- **State**: [Zustand](https://zustand-demo.pmnd.rs/)
- **Styling**: [Tailwind CSS](https://tailwindcss.com/) 4+
## 📋 Prerequisites
- **Node.js** ≥ 20.0.0
- **npm** ≥ 10.0.0
## 🚀 Quick Start
```bash
# 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
```
## 📦 Project Structure
```
packages/
core/ # Core business logic
electron/ # Electron main + preload
frontend/ # React UI (renderer)
server/ # Backend server
shared/ # Shared types & schemas
```
## 🔧 Development
```bash
# 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
```
## 🏗️ Building
```bash
# Build all packages
npm run build
# Package for current platform
npm run package -w @agentage/electron
```
Artifacts are published to [GitHub Releases](https://github.com/agentage/desktop/releases) on tag push.
## 🤝 Contributing
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
## 📄 License
See [LICENSE](LICENSE) file for details.
---
**Made with ❤️ by [Agentage](https://github.com/agentage)**