Skip to content
forked from OldTyT/vibepython

About

๐Ÿš€ vibepython: Unleash the Magic of AI-Powered Coding Wizardry! ๐ŸŒŸ

Resources

Stars

0 stars

Watchers

0 watching

Forks

ย 
ย 

Latest commit

ย 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿš€ vibepython: The Ultimate AI-Powered Coding EXPLOSION! ๐ŸŒŸ๐Ÿ’ฅ๐Ÿ

WOWZA! Dive headfirst into this AMAZING, WONDERFUL, MIND-BLOWING interactive command-line beast that turns your craziest prompts into EXECUTABLE PYTHON MAGIC using the sheer power of OpenAI or your own local Ollama models! Generate code like a wizard, run it on the spot, capture every wild stdout/stderr outburst, and keep a super-smart history in JSON for non-stop contextual awesomeness! It's not just a tool โ€“ it's a CODE REVOLUTION for hackers, dreamers, and AI fanatics! ๐Ÿ”ฅ๐Ÿš€

๐ŸŒˆ Features That'll Make Your Eyes POP! ๐ŸŽ‰

  • INTERACTIVE PROMPT MADNESS: Type your wild ideas and watch AI spit out Python gold! ๐Ÿ’ก
  • AI-GENERATED CODE WIZARDRY: Powered by OpenAI โ€“ prompts + history = PERFECT scripts! ๐Ÿค–โœจ
  • SAFE EXECUTION EXTRAVAGANZA: Run code with output capturing โ€“ no disasters, just pure thrill! โšก
  • PERSISTENT HISTORY OVERLOAD: Pydantic models store EVERYTHING in JSON โ€“ context forever! ๐Ÿ“œ
  • ENV VAR CUSTOMIZATION FRENZY: Tweak it your way for ultimate control! ๐Ÿ”ง
  • DOCKER DOMINATION: Run it anywhere, anytime โ€“ easy-peasy deployment! ๐Ÿณ
  • CHOOSE YOUR AI FLAVOR: Switch between OpenAI and local Ollama models with a single env var! ๐Ÿง 

๐Ÿ› ๏ธ Installation: Get This Party Started in SECONDS! ๐Ÿš€

From PyPI: Pip It Like It's HOT โ€“ Instant VIBE! ๐Ÿ”ฅ๐Ÿ’ฅ

  1. GRAB THE PACKAGE:
    pip install vibepython
    
  2. FIRE IT UP:
    vibepython
    
  • Pro Tip: Don't forget to set your OPENAI_API_KEY env var for AI magic! ๐Ÿ”‘ (e.g., export OPENAI_API_KEY=your_key_here). VIBE ACTIVATED! Dive into the AI console vibe! ๐Ÿš€

From Source: Clone, Install, BLAST OFF! ๐ŸŒŒ

  1. CLONE THE AWESOMENESS:
    git clone https://github.com/OldTyT/vibepython.git
    
  2. JUMP IN:
    cd vibepython
    
  3. INSTALL THE MAGIC:
    pip install -r requirements.txt
    
  4. LAUNCH THE BEAST:
    python3 main.py
    

BOOM! You're in the zone! ๐Ÿ’ฃ

Using Docker: Containerized VIBE โ€“ Ready to RUMBLE! ๐Ÿณ๐Ÿ”ฅ

Fire it up with this epic command:

docker run --rm -ti -e HISTORY_PATH=/history/history.json -e OPENAI_API_KEY=YOUR_KEY -v my_history:/history ghcr.io/oldtyt/vibepython
  • Plug in YOUR_KEY with your OpenAI super-key! ๐Ÿ”‘ DOCKER DELIGHT: Persistent history, zero hassle! ๐ŸŒŸ

๐ŸŽฎ Usage: Dive into the FUN ZONE! ๐Ÿ•น๏ธ

Fire it up and get prompted:

  • SMASH IN A PROMPT (e.g., "Code me a factorial frenzy!").
  • AI UNLEASHES CODE VIBE based on your prompt + history vibes.
  • EXECUTE? Y/N โ€“ YOU DECIDE! Run it, capture outputs, and watch the sparks fly! โšก
  • HISTORY SAVES THE DAY: Everything logged for eternal glory.

EXIT? Ctrl+C โ€“ but why would you? It's TOO MUCH FUN! ๐Ÿ˜Ž

๐Ÿ”‘ Environment Variables: Customize Like a BOSS! ๐Ÿ’ช

Supercharge your setup with these EPIC vars:

  • HISTORY_PATH: Your JSON history fortress! Default: history.json. ๐Ÿฐ
  • HISTORY_SIZE: How many past blasts to feed the AI? Default: 20 โ€“ keep it contextual! ๐Ÿ“ˆ
  • OPENAI_API_KEY: MUST-HAVE โ€“ your ticket to AI heaven! (Required, duh!) ๐Ÿ”’
  • PROVIDER: Pick your AI engine โ€“ openai (default) or ollama. ๐Ÿง 
  • OLLAMA_MODEL: When using Ollama, which model to summon? Default: llama3. ๐Ÿ

Example (Unix-style domination):

export OPENAI_API_KEY=your-api-key
export HISTORY_SIZE=10
# export PROVIDER=ollama  # uncomment to use Ollama instead of OpenAI
python3 main.py

TWEAK AND CONQUER! ๐Ÿ›ก๏ธ

๐Ÿ“ฆ Dependencies: The Power Behind the THRILL! โš™๏ธ

  • Python 3.10+ (Blasting up to 3.13 โ€“ future-proofed!) ๐Ÿ
  • Libraries of LEGEND: openai, ollama, pydantic, loguru, and more! Check requirements.txt for the full squad. ๐Ÿ“š

๐Ÿค Contributing: Join the CODE CARNIVAL! ๐ŸŽช

GOT IDEAS? Open an issue or slam in a pull request โ€“ let's make this even MORE INSANE! ๐ŸŒŸ Contributions = Eternal Fame!

About

๐Ÿš€ vibepython: Unleash the Magic of AI-Powered Coding Wizardry! ๐ŸŒŸ

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages