https://github.com/kalfasyan/desto
web-interface and cli to manage python and shell scripts in tmux sessions
https://github.com/kalfasyan/desto
bash-script-manager cli command-line-tool docker nicegui session-management tmux ui uv
Last synced: 4 months ago
JSON representation
web-interface and cli to manage python and shell scripts in tmux sessions
- Host: GitHub
- URL: https://github.com/kalfasyan/desto
- Owner: kalfasyan
- License: cc-by-4.0
- Created: 2025-05-10T06:32:28.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-02-17T06:52:47.000Z (4 months ago)
- Last Synced: 2026-02-17T12:14:36.997Z (4 months ago)
- Topics: bash-script-manager, cli, command-line-tool, docker, nicegui, session-management, tmux, ui, uv
- Language: Python
- Homepage:
- Size: 31.1 MB
- Stars: 96
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
**desto** lets you run and manage your bash and Python scripts in the background (inside `tmux` sessions) through a simple web dashboard. Launch scripts, monitor their and your system's status, view live logs, and control sessions—all from your browser.
[](https://badge.fury.io/py/desto)
[](https://pepy.tech/projects/desto)
[](https://desto.readthedocs.io/)
[](https://github.com/kalfasyan/desto/actions/workflows/ci.yml)
[](https://github.com/astral-sh/ruff)
[](https://github.com/PyCQA/bandit)
[](https://github.com/gitleaks/gitleaks-action)
---
The key features are:
- **One-click session control:** Launch, monitor, and stop `tmux` sessions from your browser.
- **🐚 Bash & 🐍 Python support:** Run both bash (`.sh`) and Python (`.py`) scripts seamlessly.
- **Script management:** Use your existing scripts, write new ones, edit, save, or delete them directly in the dashboard.
- **⭐ Favorite commands:** Save, organize, and quickly run your frequently used commands with usage tracking and search.
- **Live log viewer:** Watch script output in real time and view logs for each session.
- **Live system stats:** See real-time CPU, memory, and disk usage at a glance.
- **Scheduling:** Schedule scripts or script chains to launch at a specific date and time.
- **Script chaining:** Queue multiple scripts to run sequentially in a single session.
- **Session history:** [Redis](https://github.com/redis/redis-py) integration for persistent session tracking and history. [See what is Redis →](https://redis.io/about/)
- **Scheduled job control:** Manage scheduled jobs with a dedicated table—cancel any scheduled job with a click.
- **Session & log cleanup:** Clear session history and delete logs for all or selected sessions.
- **Notifications:** Optional Pushbullet notifications for job/session finishes — set the `DESTO_PUSHBULLET_API_KEY` environment variable or add the key in Settings to receive desktop/mobile pushes when jobs complete.
- **Persistent script & log storage:** Scripts and logs are saved in dedicated folders for easy access.
- **🖥️ Command-line interface:** Manage sessions, view logs, and control scripts from the terminal with our modern CLI. [Learn more →](https://desto.readthedocs.io/user-guide/cli/)
🎬 Demo
## ✨ `desto` Overview
👀 Dashboard Overview
🚀 Launch your scripts as `tmux` sessions
When you start `desto`, it creates `desto_scripts/` and `desto_logs/` folders in your current directory. Want to use your own locations? Just change these in the settings, or set the `DESTO_SCRIPTS_DIR` and `DESTO_LOGS_DIR` environment variables.
Your scripts show up automatically—no setup needed. Both `.sh` (bash) and `.py` (Python) scripts are supported with automatic detection and appropriate execution. Ready to launch? Just:
1. Name your `tmux` session
2. Select one of your scripts
3. (OPTIONAL) edit and save your changes
4. Click "Launch"! 🎬
✍️ Write new scripts and save them
If you want to compose a new script, you can do it right here, or simply just paste the output of your favorite LLM :) Choose between bash and Python templates with syntax highlighting and smart defaults.
⚙️ Change settings
More settings to be added!
📜 View your script's logs
## ⚡ Quick Start with Docker 🐳
The fastest way to ship `desto` is by using Docker Compose 🚢
You only need Docker and Docker Compose installed on your machine. If you don't have them yet, you can find installation instructions on the [Docker website](https://docs.docker.com/get-docker/) and [Docker Compose documentation](https://docs.docker.com/compose/install/) (or follow your favorite LLM's instructions 😉).
Start `desto` in just a few steps:
1. **Clone the repository and go to it's main directory**
```bash
git clone https://github.com/kalfasyan/desto.git && cd desto
```
2. **Start the application with Docker Compose**
```bash
docker compose up -d
```
✅ **Done!** 🎉
You’re all set—your desto dashboard is now running at:
🌐 [http://localhost:8809](http://localhost:8809)
🚀 Essential Docker & Docker Compose Commands
```bash
# Start the app in background (Docker Compose)
docker compose up -d
```
```bash
# View logs (Docker Compose)
docker compose logs -f
```
```bash
# Stop and remove services (Docker Compose)
docker compose down
```
```bash
# Rebuild and start (Docker Compose)
docker compose up -d --build
```
```bash
# Run the container directly (plain Docker)
docker run -d -p 8809:8809 \
-v $PWD/desto_scripts:/app/desto_scripts \
-v $PWD/desto_logs:/app/desto_logs \
--name desto-dashboard \
desto:latest
```
```bash
# View logs (plain Docker)
docker logs -f desto-dashboard
```
```bash
# Stop and remove the container (plain Docker)
docker stop desto-dashboard && docker rm desto-dashboard
```
## 🖥️ CLI & 📊 Dashboard Installation with `uv` or `pip`
If you are not familiar with `uv`, you may visit [uv's official website](https://docs.astral.sh/uv/getting-started/installation/) for more information.
`uv` is a super-fast Python package manager and virtual environment tool, written in Rust. It helps you manage dependencies, create isolated environments, and install packages much faster than traditional tools like pip.
### Requirements
- Python 3.11+
- [tmux](https://github.com/tmux/tmux)
- [at](https://en.wikipedia.org/wiki/At_(command)) (for scheduling features)
Check [`pyproject.toml`](pyproject.toml)
### Installation Steps
1. **Install `tmux` and `at`**
Instructions for different package managers
- **Debian/Ubuntu**
```bash
sudo apt install tmux at
```
- **Almalinux/Fedora**
```bash
sudo dnf install tmux at
```
- **Arch Linux**
```bash
sudo pacman -S tmux at
```
**Note:** The `at` package is required for scheduling features. If you don't plan to use script scheduling, you can skip installing `at`.
2. **Install `desto`**
Installation Steps
- (Recommended) With [uv](https://github.com/astral-sh/uv), simply run:
```bash
uv add desto
```
This will install desto in your project ✅
Or if you don't have a project yet, you can set up everything with [`uv`](https://docs.astral.sh/uv/getting-started/installation/):
1. [Install `uv`](https://docs.astral.sh/uv/getting-started/installation/) by following the instructions on the official site.
2. Create and set up your project:
```bash
mkdir myproject && cd myproject
uv init
uv venv
source .venv/bin/activate
uv add desto
```
Done!
- With pip:
```bash
pip install desto
```
3. **Run the Application**
```bash
desto
```
🎉 **Done!**
Open your browser and visit: [http://localhost:8809](http://localhost:8809) 🚀
### Global `desto` Installation as a `uv` Tool (includes CLI)
```bash
# Install desto CLI globally
uv tool install desto
# Or install from source
cd /path/to/desto
uv tool install . --force
```
This installs two executables:
- `desto` - Web dashboard
- `desto-cli` - Command-line interface (work in progress)
Quick CLI Usage
```bash
# Check system status
desto-cli doctor
```
```bash
# List all sessions
desto-cli sessions list
```
```bash
# Start a new session
desto-cli sessions start "my-task" "python my_script.py"
```
```bash
# View session logs
desto-cli sessions logs "my-task"
```
```bash
# Kill a session
desto-cli sessions kill "my-task"
```
```bash
# List all scripts
desto-cli scripts list
```
```bash
# Create new script
desto-cli scripts create "my_script" --type python
```
```bash
# Edit script in $EDITOR
desto-cli scripts edit "my_script"
```
```bash
# Run script in tmux session
desto-cli scripts run "my_script"
```
```bash
# Run script directly
desto-cli scripts run "my_script" --direct
```
**📖 [Full CLI Documentation →](https://desto.readthedocs.io/user-guide/cli/)**
The CLI provides the same functionality as the web interface but optimized for terminal use, including rich formatting, real-time log viewing, and comprehensive session management.
---
## License
Shield: [![CC BY 4.0][cc-by-shield]][cc-by]
This work is licensed under a
[Creative Commons Attribution 4.0 International License][cc-by].
[![CC BY 4.0][cc-by-image]][cc-by]
[cc-by]: http://creativecommons.org/licenses/by/4.0/
[cc-by-image]: https://i.creativecommons.org/l/by/4.0/88x31.png
[cc-by-shield]: https://img.shields.io/badge/License-CC%20BY%204.0-lightgrey.svg
---
## TODO
- [ ] Explore possibility to pause processes running inside a session
- [ ] Add dark mode/theme toggle for the dashboard UI
---
**desto** makes handling tmux sessions and running scripts approachable for everyone—no terminal gymnastics required!