viberandom 0.1.0

Random number generation library that uses Gemini to generate numbers with vibes

VibeRandom 🎲

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

Installation

Install the package:

pip install viberandom

Set your Gemini API key as an environment variable:

export GEMINI_API_KEY=your_key_here

Usage

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]

Vibe Ideas

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

Parameters

• 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)

Fallback Behavior

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.

Testing

pytest tests/

Dependencies

• google-generativeai
• pydantic
• typing-extensions

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

Fun Examples

# 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! 🎉