nuvom 0.10

A Fast, Windows-First Task Queue for Python. Simple, Reliable, and Cross-Platform.

nuvom

🧠 Lightweight, plugin-first task queue for Python. No Redis, Windows-native, AST-powered task discovery, and extensible by design.

---

✨ Why Nuvom?

Nuvom is a developer-first job execution engine that helps you queue, execute, and persist background tasks—without needing Redis, Celery, or any infrastructure.

Key philosophies:

• 🪟 Windows-native (no Linux-only assumptions)
• 🔌 Plugin-first: easily extend queues, backends, and task loaders
• ⚙️ No Redis, no brokers, and no external services
• 📜 Static task discovery via AST parsing — zero import side-effects
• ⚡ Manifest caching for fast CLI performance

---

📖 Documentation

Full guides and reference material are available in the docs/ directory:

• Quickstart
• CLI Reference
• Core Concepts
• Architecture Overview
• Plugin System
• Configuration
• Roadmap & Milestones
• FAQ

---

📦 Installation

Nuvom is currently in active development. Until v1.0, install locally:

git clone https://github.com/nahom-zewdu/Nuvom
cd Nuvom
pip install -e .

---

⚙️ Quickstart

1. Define a Task

from nuvom.task import task

@task(retries=2, retry_delay_secs=5, timeout_secs=3, store_result=True)
def add(x, y):
    return x + y

2. Queue a Job

from tasks import add

job = add.delay(5, 7)
print(job.id)

3. Run the Worker

nuvom runworker

4. Inspect Job Result

nuvom inspect job <job_id>

---

🧪 CLI Overview

Nuvom provides a rich CLI for listing tasks, inspecting job metadata, retrying failures, and managing plugins.

nuvom --help

Full command list: CLI Reference

---

🔧 Configuration

Nuvom uses .env-based configuration powered by pydantic-settings. Full details: Configuration Guide

---

📊 Monitoring

Nuvom includes a Prometheus plugin that exposes live metrics (queue size, in-flight jobs, worker count).

Enable it via .nuvom_plugins.toml. More: Prometheus Plugin

---

🧩 Plugin System

All major components — queue, backend, discovery — are pluggable. Write your own plugins or load third-party ones via .nuvom_plugins.toml.

Start here: Plugin System

---

🛠 Extending Nuvom

Want to register your own result backend or queue engine? Nuvom makes it easy to implement plugins that hook into its core lifecycle.

Learn how: Architecture Overview

---

🛣 Roadmap

Nuvom follows a milestone-based release cadence. See: Roadmap

---

👥 Contributing

Pull requests are welcome!

See:

• Architecture Guide
• Contributing Instructions

---

🪪 License

Apache 2.0 — use it freely, build responsibly.

---

📚 Documentation

Nuvom uses MkDocs with the Material for MkDocs theme for documentation.

🧪 Local Preview

To build and preview the documentation locally:

hatch shell
mkdocs serve

📦 Static Site Build

To build the static documentation site:

mkdocs build

🧰 Tech Stack

• mkdocs-material — for styling and navigation
• mkdocstrings[python] — for automated API docs
• mkdocs-git-revision-date-localized-plugin — for revision metadata

All documentation dependencies are managed via Hatch. No need to install anything manually.

---