Hugo Admin - A Lightweight Hugo Blog Management Interface

Tue, 23 Dec 2025 16:00:00 +0800

When managing a Hugo blog, you often need to switch back and forth between the terminal and editor. To simplify this process, I developed hugo-admin, a lightweight web management interface based on Flask.

Why It’s Needed

The typical workflow for writing Hugo blogs is:

Execute hugo new post/xxx.md in terminal
Open the file with an editor to write content
Start hugo server in terminal to preview
Switch to browser to check the effect
If not satisfied, return to editor to modify

This workflow is fine, but it would be more convenient if all operations could be completed in one place.

Main Features

hugo-admin provides the following features:

Dashboard: Blog statistics overview
Article Management: Browse, search, filter articles
Markdown Editor: Online editing with auto-save support
Hugo Server Control: Start/stop server, view logs in real-time
Image Management: Upload and manage article images

Interface Display

Tech Stack

Backend uses Flask + Flask-SocketIO, frontend uses Tailwind CSS + Alpine.js. Real-time log pushing is implemented based on WebSocket.

1
2
3
4
5
6
7
8


hugo-admin/
├── app.py # Flask application
├── services/ # Business logic layer
│ ├── hugo_service.py # Hugo server management
│ ├── post_service.py # Article operations
│ └── cache_service.py # Cache layer
├── templates/ # Jinja2 templates
└── static/ # Static resources

Installation and Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


# Clone repository
git clone https://github.com/Svtter/hugo-admin.git
cd hugo-admin

# Install dependencies
pip install -r requirements.txt

# Configure Hugo directory
cp config.py config_local.py
# Edit config_local.py to set HUGO_ROOT

# Start
python app.py

After starting, visit http://127.0.0.1:5000.

Core Implementation

The Python version uses SQLite for caching to avoid scanning the file system every time:

1

post_service = PostService(app.config['CONTENT_DIR'], use_cache=True)

Hugo server control manages processes based on psutil, supporting real-time log pushing:

1

hugo_manager = HugoServerManager(app.config['HUGO_ROOT'], socketio)

Advanced Version

Besides the open-source Python version, I also developed a Go language implementation of the advanced version. Compared to the open-source version, the Go version has the following advantages:

Higher performance: Compiled Go language executes more efficiently
Lower resource usage: Less memory and CPU usage
Single file deployment: Compiled into a single executable file, no need for dependency environment
More features: Includes more advanced features
Direct Hugo API usage: No need for SQLite3 cache, directly calls Hugo API to get article information, more lightweight and efficient

The advanced version is priced at $10 USD. Click here to purchase to get complete source code. If you have higher requirements for performance and deployment convenience, consider the advanced version.

Future Plans

Git operations interface
Batch operation support
Docker deployment

The project is open source, welcome to Star and PR.

博客 on Svtter's Blog