Metadata-Version: 2.4
Name: viberandom
Version: 0.1.0
Summary: Random number generation library that uses Gemini to generate numbers with vibes
Author-email: jeantimex <jean.timex@gmail.com>
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: google-generativeai>=0.8.0
Requires-Dist: pydantic>=2.11.7
Requires-Dist: typing-extensions>=4.14.1
Description-Content-Type: text/markdown

# VibeRandom 🎲

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

## Installation

Install the package:
```bash
pip install viberandom
```

Set your Gemini API key as an environment variable:
```bash
export GEMINI_API_KEY=your_key_here
```

## Usage

```python
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

```bash
pytest tests/
```

## Dependencies

- google-generativeai
- pydantic
- typing-extensions

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

## Fun Examples

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