Skip to main content

VibeCheck Logo

"VibeCheck: The Virtual Senior Developer in Your Terminal"

PyPI Python Versions License

PRs Welcome Stars Twitter Instagram


AI-Powered Code Auditing with a "Senior Developer" Vibe.

VibeCheck is an interactive CLI tool designed to help developers understand, audit, and secure their codebase. It combines strict rule-based scanning with advanced AI explanations to ensure you don't just fix bugs—you learn from them.


🎬 Cinematic Walkthrough

1. Project-Specific Rules
2. Security Audit
3. Educational Analogies (ELI5)
4. Security Deep-Dive
5. Concept Memory Tracking
6. AI Fix Suggestions
7. Interactive Chat Mode
Ready for Launch

✨ Key Features

🛡️ Rule-Based Engine & Local Guidelines

VibeCheck doesn't just use AI; it uses a strict engine to catch SQL Injections, Hardcoded Credentials, and more. Most importantly, it reads your .vibecheck_rules.md to enforce your team's specific coding standards.

🧠 Smart Global Caching

Performance matters. VibeCheck caches every AI response in your home directory (~/.vibecheck/cache). Scan once, and the next scan is instant and completely free.

🎓 Pedagogical AI (ELI5)

Switch to --learn mode to get complex technical flaws explained through simple real-world analogies. Perfect for junior developers and students.

💬 Interactive Terminal Chat

Don't understand a specific issue? Launch --chat mode to have a direct conversation with the "Virtual Senior Developer" about your code.


🚀 Quick Start

1. Installation

pip install vibecheck-ai-tool

2. Configure API Key

VibeCheck is universal. It automatically detects your provider.

Provider Environment Variable Default Model
Groq (Fastest) GROQ_API_KEY llama-3.3-70b
OpenAI OPENAI_API_KEY gpt-4o-mini
Anthropic ANTHROPIC_API_KEY claude-3.5-sonnet
Google GOOGLE_API_KEY gemini-1.5-pro
Ollama VIBECHECK_ENTERPRISE_MODE=1 ollama/llama3
# Example for Groq
$env:GROQ_API_KEY = "your-key-here"

3. Run Your First Audit

vibecheck examples/python_bad.py --learn

👨‍💻 Developed by a 16-Year-Old Creator

Created in 24 hours to prove that AI tools should focus on education, not just automation. Architected & Maintained by Afif Erdita.


📄 License

MIT License.

Metadata

Release files for vibecheck-ai-tool 1.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for vibecheck-ai-tool 1.0.2
File Size Uploaded Provenance Actions
vibecheck_ai_tool-1.0.2.tar.gz 35.1 kB Without provenance Details for vibecheck_ai_tool-1.0.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for vibecheck-ai-tool 1.0.2
File Interpreter ABI Platform Actions
vibecheck_ai_tool-1.0.2-py3-none-any.whl Python 3 none any Details for vibecheck_ai_tool-1.0.2-py3-none-any.whl

Total release size: 67.9 kB

Release files / vibecheck_ai_tool-1.0.2.tar.gz

Download URL vibecheck_ai_tool-1.0.2.tar.gz
Size 35.1 kB
Tags Source
SHA-256 checksum
How to use checksums
8d9c27bfc476ba9e06fb5be6ea0350f61aa6ed54559c276b76763cdf8b9f4f78
BLAKE2b-256 checksum
How to use checksums
469497d15f0f38e30bccf435397fb5ac2a3047676872c59075140d6bae44370e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.9

Release files / vibecheck_ai_tool-1.0.2-py3-none-any.whl

Download URL vibecheck_ai_tool-1.0.2-py3-none-any.whl
Size 32.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
abd5de9b56d67e7f1cc01b2da23623181e2c12a6619d36b57a2bd400837176c6
BLAKE2b-256 checksum
How to use checksums
7967b8156bfe020464bd1c7b82740220ecfbf57be6d2743afd4814bfc70e19a3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.9

Security for vibecheck-ai-tool 1.0.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.2 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page