nozie 0.3.0

Your code, always running. Nozie fixes itself.

Nozie

Your code, always running. Nozie fixes itself.

Nozie is a lightweight monitoring probe for Docker containers. Drop it into any project — it watches your containers, detects errors in logs, and sends them to the Nozie backend where AI analysis and automatic GitHub fix PRs happen.

No AI keys or GitHub tokens needed on your server. The agent is just a thin probe.

Install

pip install nozie

Quick Start

import time
from nozie import NozieAgent

NozieAgent(api_key="nz_k_...").start()

# Keep your process alive
while True:
    time.sleep(1)

Docker

Add a dedicated container to your docker-compose.yml:

services:
  nozie-agent:
    image: python:3.11-slim
    command: python main.py
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock  # required
    environment:
      - NOZIE_API_KEY=nz_k_...

Or build your own image:

FROM python:3.11-slim
RUN pip install nozie
COPY main.py .
CMD ["python", "main.py"]

# main.py
import time
from nozie import NozieAgent

NozieAgent(api_key="nz_k_...").start()

while True:
    time.sleep(1)

Configuration

Parameter	Default	Description
api_key	required	Your Nozie API key from the dashboard
container	None	Specific container name to monitor. None = all containers
stats_interval	30	Seconds between heartbeat stats reports
error_cooldown	60	Minimum seconds between error reports per container

How It Works

1. Agent connects to the local Docker daemon via socket
2. Streams logs from all running containers (or a specific one)
3. Detects ERROR, Exception, Traceback, FATAL keywords
4. Sends the last 50 log lines to the Nozie backend
5. Backend runs AI analysis and opens a GitHub PR with the fix

The agent runs entirely in background daemon threads — it never blocks your application.

Requirements

• Python >= 3.8
• Docker socket access (/var/run/docker.sock)

License

MIT