Skip to main content

aydie_genai

aydie_genai Banner

A simple, unified, and powerful Python library for generative AI.

License


aydie_genai is a Python library designed to eliminate the complexity of working with multiple Generative AI models. Instead of writing different code for Gemini, OpenAI, Claude, Groq, and others, you can use one simple, unified function to access them all.

Key Features

  • Unified Interface: A single generate() function for all supported models.
  • Simple & Intuitive: Get started in minutes. No need to learn multiple SDKs.
  • Provider Agnostic: Switch between models like gpt-4o and gemini-1.5-pro by changing a single string.
  • Built-in Documentation: Rich docstrings provide in-console help via help(genai.generate).
  • Robust Error Handling: Custom exceptions for common issues like missing API keys.

Supported Models

Provider Supported Models Environment Variable
Google gemini-1.5-pro, gemini-1.5-flash, gemini-1.0-pro, gemini-2.5-pro, gemini-2.5-flash GOOGLE_API_KEY
OpenAI gpt-4o, gpt-4-turbo, gpt-3.5-turbo, gpt-4.1, gpt-4.1-mini OPENAI_API_KEY
Anthropic claude-3-opus-20240229, claude-3-sonnet-20240229, claude-3-haiku-20240307, claude-3.5-sonnet ANTHROPIC_API_KEY
Groq llama3-70b-8192, llama3-8b-8192, mixtral-8x7b-32768, llama3-70b-131k GROQ_API_KEY
DeepSeek deepseek-chat, deepseek-coder, deepseek-v2-chat DEEPSEEK_API_KEY

Installation

Install aydie_genai directly from PyPI:

pip install aydie-genai

⚡ Quick Start

1. Set Up Your API Keys

The library loads API keys from environment variables. The easiest way to manage these is to create a .env file in your project's root directory:

# .env file
GOOGLE_API_KEY="your_google_api_key"
OPENAI_API_KEY="your_openai_api_key"
ANTHROPIC_API_KEY="your_anthropic_api_key"
GROQ_API_KEY="your_groq_api_key"
DEEPSEEK_API_KEY="your_deepseek_api_key"

2. Generate a Response

Using the library is incredibly simple. Just import genai and call the generate function.

from aydie_genai import genai

# Example 1: Using Google Gemini
response_gemini = genai.generate(
    model='gemini-1.5-pro',
    prompt='Explain the theory of relativity in simple terms for a five-year-old.',
    system_instruction='You are a friendly and patient teacher.'
)
print("Gemini says:", response_gemini)

# Example 2: Switching to OpenAI's GPT-4o is as easy as changing the model name
response_openai = genai.generate(
    model='gpt-4o',
    prompt='Write a short story about a robot who discovers music.'
)
print("\nOpenAI says:", response_openai)

Function Parameters

The genai.generate() function accepts the following parameters:

Parameter Type Description
model str Required. The identifier for the model you want to use (e.g., 'gpt-4o').
prompt str Required. The main user input or question for the model.
system_instruction str A directive to guide the model's behavior or personality.
temperature float Controls randomness (0.0 for deterministic, 2.0 for random). Defaults to 1.0.
max_tokens int The maximum number of tokens to generate in the response. Defaults to 2048.
top_p float Nucleus sampling parameter. Defaults to 1.0.
api_key str Directly pass an API key, overriding the environment variable. Defaults to None.

Contributing

Contributions are welcome! Whether it's adding new models, improving documentation, or fixing bugs, your help is appreciated. Please feel free to open an issue or submit a pull request.

License

This project is licensed under the MIT License - see the LICENSE file for details.


Connect with Me

Website LinkedIn Twitter Instagram YouTube GitLab Email

Metadata

Release files for aydie-genai 1.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aydie-genai 1.1.0
File Size Uploaded
aydie_genai-1.1.0.tar.gz 14.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for aydie-genai 1.1.0
File Interpreter ABI Platform
aydie_genai-1.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 33.3 kB

Release files / aydie_genai-1.1.0.tar.gz

Download URL aydie_genai-1.1.0.tar.gz
Size 14.2 kB
Tags Source
SHA-256 checksum
How to use checksums
b5c72ca36b9499571728617d726a919733805b78ebd864271adb4a12f9b37691
BLAKE2b-256 checksum
How to use checksums
039befb4c2cb48449425cd91845282a0001a0b32fc55c40b6dcea4ef46b76387
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.7

Release files / aydie_genai-1.1.0-py3-none-any.whl

Download URL aydie_genai-1.1.0-py3-none-any.whl
Size 19.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8f7f877f0a069915d3fcb8faa688ba9480863e3bcec37bfb0bbdd939c0e13d83
BLAKE2b-256 checksum
How to use checksums
b9cdbd497be74298060536b6e2fc4707a2c9fff5ccd962a428a7c29c5889bcd8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.7

Release history Release notifications | RSS feed

This release

1.1.0 This release

2 release files

1.0.2

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page