Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/AK391/ai-gradio

Last synced: 8 days ago
JSON representation
Host: GitHub
URL: https://github.com/AK391/ai-gradio
Owner: AK391
Created: 2024-12-14T06:02:33.000Z (about 1 month ago)
Default Branch: master
Last Pushed: 2025-01-07T18:01:26.000Z (12 days ago)
Last Synced: 2025-01-07T18:33:03.816Z (12 days ago)
Language: Python
Size: 220 KB
Stars: 202
Watchers: 2
Forks: 18
Open Issues: 3
Metadata Files:
- Readme: README.md
Awesome Lists containing this project

awesome - AK391/ai-gradio - (Python)
README

        # ai-gradio

A Python package that makes it easy for developers to create machine learning apps powered by various AI providers. Built on top of Gradio, it provides a unified interface for multiple AI models and services.

## Features

### Core Features

- **Multi-Provider Support**: Integrate with 15+ AI providers including OpenAI, Google Gemini, Anthropic, and more

- **Text Chat**: Interactive chat interfaces for all text models

- **Voice Chat**: Real-time voice interactions with OpenAI models

- **Video Chat**: Video processing capabilities with Gemini models

- **Code Generation**: Specialized interfaces for coding assistance

- **Multi-Modal**: Support for text, image, and video inputs

- **Agent Teams**: CrewAI integration for collaborative AI tasks

- **Browser Automation**: AI agents that can perform web-based tasks

### Model Support

#### Core Language Models

| Provider | Models |

|----------|---------|

| OpenAI | gpt-4-turbo, gpt-4, gpt-3.5-turbo |

| Anthropic | claude-3-opus, claude-3-sonnet, claude-3-haiku |

| Gemini | gemini-pro, gemini-pro-vision, gemini-2.0-flash-exp |

| Groq | llama-3.2-70b-chat, mixtral-8x7b-chat |

#### Specialized Models

| Provider | Type | Models |

|----------|------|---------|

| LumaAI | Generation | dream-machine, photon-1 |

| DeepSeek | Multi-purpose | deepseek-chat, deepseek-coder, deepseek-vision |

| CrewAI | Agent Teams | Support Team, Article Team |

| Qwen | Language | qwen-turbo, qwen-plus, qwen-max |

| Browser | Automation | browser-use-agent |

## Installation

### Basic Installation

```bash

# Install core package

pip install ai-gradio

# Install with specific provider support

pip install 'ai-gradio[openai]'     # OpenAI support

pip install 'ai-gradio[gemini]'     # Google Gemini support

pip install 'ai-gradio[anthropic]'  # Anthropic Claude support

pip install 'ai-gradio[groq]'       # Groq support

# Install all providers

pip install 'ai-gradio[all]'

```

### Additional Providers

```bash

pip install 'ai-gradio[crewai]'     # CrewAI support

pip install 'ai-gradio[lumaai]'     # LumaAI support

pip install 'ai-gradio[xai]'        # XAI/Grok support

pip install 'ai-gradio[cohere]'     # Cohere support

pip install 'ai-gradio[sambanova]'  # SambaNova support

pip install 'ai-gradio[hyperbolic]' # Hyperbolic support

pip install 'ai-gradio[deepseek]'   # DeepSeek support

pip install 'ai-gradio[smolagents]' # SmolagentsAI support

pip install 'ai-gradio[fireworks]'  # Fireworks support

pip install 'ai-gradio[together]'   # Together support

pip install 'ai-gradio[qwen]'       # Qwen support

pip install 'ai-gradio[browser]'    # Browser support

```

## Usage

### API Key Configuration

```bash

# Core Providers

export OPENAI_API_KEY=

export GEMINI_API_KEY=

export ANTHROPIC_API_KEY=

export GROQ_API_KEY=

# Additional Providers (as needed)

export LUMAAI_API_KEY=

export XAI_API_KEY=

export COHERE_API_KEY=

# ... (other provider keys)

# Twilio credentials (required for WebRTC voice chat)

export TWILIO_ACCOUNT_SID=

export TWILIO_AUTH_TOKEN=

```

### Quick Start

```python

import gradio as gr

import ai_gradio

# Create a simple chat interface

gr.load(

    name='openai:gpt-4-turbo',  # or 'gemini:gemini-1.5-flash', 'groq:llama-3.2-70b-chat'

    src=ai_gradio.registry,

    title='AI Chat',

    description='Chat with an AI model'

).launch()

# Create a chat interface with Transformers models

gr.load(

    name='transformers:phi-4',  # or 'transformers:tulu-3', 'transformers:olmo-2-13b'

    src=ai_gradio.registry,

    title='Local AI Chat',

    description='Chat with locally running models'

).launch()

# Create a coding assistant with OpenAI

gr.load(

    name='openai:gpt-4-turbo',

    src=ai_gradio.registry,

    coder=True,

    title='OpenAI Code Assistant',

    description='OpenAI Code Generator'

).launch()

# Create a coding assistant with Gemini

gr.load(

    name='gemini:gemini-2.0-flash-thinking-exp-1219',  # or 'openai:gpt-4-turbo', 'anthropic:claude-3-opus'

    src=ai_gradio.registry,

    coder=True,

    title='Gemini Code Generator',

).launch()

```

### Advanced Features

#### Voice Chat

```python

gr.load(

    name='openai:gpt-4-turbo',

    src=ai_gradio.registry,

    enable_voice=True,

    title='AI Voice Assistant'

).launch()

```

#### Camera Mode

```python

# Create a vision-enabled interface with camera support

gr.load(

    name='gemini:gemini-2.0-flash-exp',

    src=ai_gradio.registry,

    camera=True,

).launch()

```

#### Multi-Provider Interface

```python

import gradio as gr

import ai_gradio

with gr.Blocks() as demo:

    with gr.Tab("Text"):

        gr.load('openai:gpt-4-turbo', src=ai_gradio.registry)

    with gr.Tab("Vision"):

        gr.load('gemini:gemini-pro-vision', src=ai_gradio.registry)

    with gr.Tab("Code"):

        gr.load('deepseek:deepseek-coder', src=ai_gradio.registry)

demo.launch()

```

#### CrewAI Teams

```python

# Article Creation Team

gr.load(

    name='crewai:gpt-4-turbo',

    src=ai_gradio.registry,

    crew_type='article',

    title='AI Writing Team'

).launch()

```

#### Browser Automation

```bash

playwright install

```

use python 3.11+ for browser use

```python

import gradio as gr

import ai_gradio

# Create a browser automation interface

gr.load(

    name='browser:gpt-4-turbo',

    src=ai_gradio.registry,

    title='AI Browser Assistant',

    description='Let AI help with web tasks'

).launch()

```

Example tasks:

- Flight searches on Google Flights

- Weather lookups

- Product price comparisons

- News searches

#### Swarms Integration

```python

import gradio as gr

import ai_gradio

# Create a chat interface with Swarms

gr.load(

    name='swarms:gpt-4-turbo',  # or other OpenAI models

    src=ai_gradio.registry,

    agent_name="Stock-Analysis-Agent",  # customize agent name

    title='Swarms Chat',

    description='Chat with an AI agent powered by Swarms'

).launch()

```

## Requirements

### Core Requirements

- Python 3.10+

- gradio >= 5.9.1

### Optional Features

- Voice Chat: gradio-webrtc, numba==0.60.0, pydub, librosa

- Video Chat: opencv-python, Pillow

- Agent Teams: crewai>=0.1.0, langchain>=0.1.0

## Troubleshooting

### Authentication Issues

If you encounter 401 errors, verify your API keys:

```python

import os

# Set API keys manually if needed

os.environ["OPENAI_API_KEY"] = "your-api-key"

os.environ["GEMINI_API_KEY"] = "your-api-key"

```

### Provider Installation

If you see "no providers installed" errors:

```bash

# Install specific provider

pip install 'ai-gradio[provider_name]'

# Or install all providers

pip install 'ai-gradio[all]'

```

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.