AI-powered random number generation using Gemini Flash API. Generate numbers that match your vibe!

Install the package:

pip install viberandom

Set your Gemini API key as an environment variable:

export GEMINI_API_KEY=your_key_here

from viberandom import viberandom, viberandom_single

# Generate lucky numbers
lucky_nums = viberandom(1, 100, "lucky", count=5)
print(lucky_nums)  # e.g., [7, 77, 13, 888, 21]

# Generate a single chaotic number
chaos = viberandom_single(1, 1000, "chaotic")
print(chaos)  # e.g., 347

# Generate peaceful numbers
peaceful = viberandom(1, 50, "peaceful", count=3)
print(peaceful)  # e.g., [10, 20, 30]

# Generate energetic numbers
energy = viberandom(50, 100, "energetic", count=4)
print(energy)  # e.g., [89, 97, 83, 91]

Try these vibes for different number personalities:

• lucky - Numbers that feel fortunate (7, 77, 888, etc.)
• chaotic - Unpredictable, irregular numbers
• peaceful - Round, harmonious numbers
• energetic - High, dynamic numbers
• mysterious - Numbers with enigmatic qualities
• cozy - Warm, comfortable feeling numbers
• dramatic - Bold, striking numbers
• vintage - Numbers that feel classic or retro
• cosmic - Space-age, otherworldly numbers
• spicy - Numbers with kick and attitude

• min_value (int): Minimum value for random numbers (default: 1)
• max_value (int): Maximum value for random numbers (default: 100)
• vibe (str): The feeling/vibe for the numbers (default: "random")
• count (int): How many numbers to generate (default: 1)

If the AI fails to generate numbers (network issues, invalid API key, etc.), VibeRandom automatically falls back to regular random number generation to ensure your code never breaks.

pytest tests/

• google-generativeai
• pydantic
• typing-extensions

⚠️ Requires Gemini API key. Experimental project - not for production use.

# Generate lottery numbers with "millionaire" vibes
lottery = viberandom(1, 69, "millionaire", count=6)

# Get a spooky number for Halloween
spooky = viberandom_single(13, 666, "spooky")

# Generate zen meditation numbers
zen = viberandom(1, 108, "zen", count=3)

# Create birthday party numbers
party = viberandom(1, 31, "celebration", count=1)

Have fun with AI-powered randomness! 🎉