🔥 devils-help

Your Personal AI Devil — a password-locked coding assistant powered by Groq's Llama 4 Scout model.

devils-help solves competitive programming problems and software engineering challenges directly from plain text or screenshots. The Groq API key is pre-baked into the package — you only need a password to unlock it.

Installation

pip install devils-help

Requires Python ≥ 3.9

Quick Start

import devil

# 1. Authenticate — raises AuthenticationError on wrong password
cn = devil.connect(pwd="devil123")

# 2. Solve from plain text (returns Python code only)
cn.ask(text="Find the longest increasing subsequence", mode="code", lang="python")

# 3. Explain a problem from a screenshot
cn.ask(image="problem.png", mode="explain")

# 4. Full solution — explanation + code, saved to a file
cn.ask(
    text="Solve this",
    image="q.png",
    mode="both",
    lang="cpp",
    prompt="Optimize for O(n log n)",
    save="output/solution.txt",
)

ask() Parameters

* At least one of text or image must be provided. Both can be used together.

Modes

Supported Image Formats

Notes

• API key — Pre-configured inside the package. End-users never need to set or see it.
• Password — Required to access the assistant via devil.connect(pwd=...). The password is never stored in plaintext — only its SHA-256 hash is used for verification.
• Model — Uses Groq's meta-llama/llama-4-scout-17b-16e-instruct (vision-capable).

License

MIT © 2025 Madhav