aiwand 0.3.0

A simple AI toolkit for text processing using OpenAI and Gemini APIs

AIWand 🪄

A simple and elegant Python package for AI-powered text processing using OpenAI and Google Gemini APIs.

✨ Features

• Smart Provider Selection - Automatically uses OpenAI or Gemini based on available keys
• Text Summarization - Create concise, detailed, or bullet-point summaries
• AI Chat - Have conversations with context history
• Text Generation - Generate content from prompts
• CLI Interface - Use from command line
• Virtual Environment Ready - Easy setup with automated scripts

🚀 Quick Start

Installation

# Using pip
pip install aiwand

# With virtual environment (recommended)
python -m venv .venv
source .venv/bin/activate  # Linux/Mac
pip install aiwand

Basic Usage

import aiwand

# Set your API key
aiwand.configure_api_key("your-api-key", "openai")  # or "gemini"

# Summarize text
summary = aiwand.summarize("Your long text here...")

# Chat with AI  
response = aiwand.chat("What is machine learning?")

# Generate text
story = aiwand.generate_text("Write a poem about coding")

CLI Usage

# Direct prompts (easiest way!)
aiwand "Ten fun names for a pet pelican"
aiwand "Explain quantum computing in simple terms" 
aiwand "Write a haiku about programming"

# Or use specific commands
aiwand summarize "Your text here" --style bullet-points
aiwand chat "What is machine learning?"
aiwand generate "Write a story about AI"

🔧 Configuration

Set your API keys via environment variables:

# Option 1: OpenAI
export OPENAI_API_KEY="your-openai-key"

# Option 2: Gemini  
export GEMINI_API_KEY="your-gemini-key"

# Option 3: Both (set preference)
export OPENAI_API_KEY="your-openai-key"
export GEMINI_API_KEY="your-gemini-key"
export AI_DEFAULT_PROVIDER="gemini"  # or "openai"

Or use a .env file:

OPENAI_API_KEY=your-openai-key
GEMINI_API_KEY=your-gemini-key
AI_DEFAULT_PROVIDER=openai

📚 Documentation

• Installation Guide - Detailed setup instructions
• API Reference - Complete function documentation
• CLI Reference - Command line usage
• Virtual Environment Guide - Best practices for Python environments

🤝 Connect

• GitHub: github.com/onlyoneaman/aiwand
• PyPI: pypi.org/project/aiwand
• X (Twitter): @onlyoneaman

📝 License

MIT License - see LICENSE file for details.

---

Made with ❤️ by Aman Kumar