whyour/qinglong

📈 Trending★ 19,553TypeScriptAudience · developerComplexity · 3/5ActiveLicenseSetup · moderate

Mindmap

mindmap
  root((repo))
    What it does
      Schedule scripts
      Run on timer
      Web interface
      Multi-language
    Supported languages
      Python 3
      JavaScript
      TypeScript
      Shell scripts
    Features
      Environment variables
      Task logs
      Dark mode
      Mobile support
    Deployment
      Docker images
      npm install
      Linux systems
    Use cases
      Website check-ins
      API automation
      Data collection
      Task scheduling

mindmap root((repo)) What it does Schedule scripts Run on timer Web interface Multi-language Supported languages Python 3 JavaScript TypeScript Shell scripts Features Environment variables Task logs Dark mode Mobile support Deployment Docker images npm install Linux systems Use cases Website check-ins API automation Data collection Task scheduling

Things people build with this

USE CASE 1

Automate daily website check-ins or logins without manual intervention.

USE CASE 2

Schedule API calls to run at specific times to collect or sync data.

USE CASE 3

Run data collection jobs periodically without keeping a computer running.

USE CASE 4

Manage multiple scripts across different languages from a single web dashboard.

Tech stack

TypeScriptNode.jsDockerPythonJavaScript

Getting it running

Difficulty · moderate Time to first run · 30min

Requires Docker to run; needs to pull images and start containers before accessing the web UI.

Use freely for any purpose including commercial. Keep the notice and disclose changes to the patent grant.

In plain English

Qinglong (青龙) is a scheduled task management platform, a self-hosted tool for running automated scripts on a timer, similar to how cron jobs work on Linux servers, but with a full web-based management interface. The problem it solves is the need to run scripts regularly (for example, every hour or every day) across multiple scripting languages, without needing to be a server administration expert. You deploy it via Docker, access it through a browser, and manage everything from the web UI. The platform supports scripts written in Python 3, JavaScript, TypeScript, and shell scripts. Through the web interface you can add new scripts, set their schedules down to the second, manage environment variables (useful for storing API keys or credentials your scripts need), edit configuration files, and view logs from each task run. It also supports system-level notifications, a dark mode, and mobile device operation. Someone would use Qinglong when they want to automate repetitive online tasks, such as checking in to websites, running API calls on a schedule, or performing data collection jobs, without leaving a laptop running. Deployment uses Docker (available as Alpine or Debian-based images) or npm on Debian/Ubuntu/Alpine Linux systems. The project is primarily documented in Chinese but includes an English README.

Copy-paste prompts

Prompt 1

How do I set up Qinglong with Docker and add my first scheduled Python script?

Prompt 2

Show me how to configure environment variables in Qinglong for storing API keys my scripts need.

Prompt 3

What's the syntax for setting up a cron-like schedule in Qinglong to run a task every 6 hours?

Prompt 4

How do I view logs and debug a scheduled task that failed in Qinglong?

Prompt 5

Can I run JavaScript and Python scripts together in Qinglong, and how do I manage them?

Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.