CoolFace
Apppublic

Omniscient001/Omniscient

sourceHugging Faceupdated 1y agoView on Hugging Face
1likes
App README

<div align="center">

๐Ÿง  Omniscient

"The all-knowing AI that sees everything, knows everything"

![Python](https://python.org) ![License](LICENSE) ![Streamlit](https://streamlit.io) ![HuggingFace](https://huggingface.co/spaces/Omniscient001/Omniscient)

A versatile AI bot for image analysis and dataset curation with support for multiple AI models

๐ŸŽฎ [Try it Live on HuggingFace!](https://huggingface.co/spaces/Omniscient001/Omniscient) (Actively WIP)

</div>


โœจ Features

<table> <tr> <td width="50%">

๐Ÿ—ƒ๏ธ Dataset Curation

Generate and curate high-quality image datasets with intelligent filtering and categorization.

๐Ÿ” Image Analysis with multiple angle

Benchmark different AI models on individual images with detailed performance metrics.

</td> <td width="50%">

๐Ÿค– Agentic Analysis

Multi-step AI reasoning and analysis with advanced decision-making capabilities.

๐ŸŒ Multiple AI Providers

Seamless integration with OpenAI, Anthropic, and Google AI platforms.

</td> </tr> </table>


๐Ÿš€ Quick Start

๐Ÿ“‹ Step 1: Setup Environment

bash
cd simple_G_ai_bot

Create a .env file in the project root:

bash
# ๐Ÿ” .env
OPENAI_API_KEY=your_openai_api_key_here
ANTHROPIC_API_KEY=your_anthropic_api_key_here
GOOGLE_API_KEY=your_google_api_key_here

๐Ÿ“ฆ Step 2: Install Dependencies

bash
uv sync

๐ŸŽฏ Step 3: Usage Examples

<details> <summary><b>๐Ÿ—๏ธ Dataset Curation</b></summary>

Generate 50 urban outdoor samples:

bash
python main.py --mode data --samples 50 --urban --no-indoor

</details>

<details> <summary><b>โšก Single Image Analysis</b></summary>

Benchmark GPT-4o on 5 samples:

bash
python main.py --mode benchmark --models gpt-4o --samples 5

</details>

<details> <summary><b>๐Ÿง  Agentic Analysis</b></summary>

Run multi-step analysis with Gemini:

bash
python main.py --mode agent --model gemini-2.5-pro --steps 10 --samples 5

</details>


โš™๏ธ Configuration

๐Ÿ”‘ Environment Variables

VariableDescriptionStatus
OPENAI_API_KEYOpenAI API key for GPT models๐Ÿ”ถ Optional
ANTHROPIC_API_KEYAnthropic API key for Claude models๐Ÿ”ถ Optional
GOOGLE_API_KEYGoogle AI API key for Gemini models๐Ÿ”ถ Optional

๐Ÿ› ๏ธ Command Line Options

๐ŸŒŸ Common Options
  • โ€”--mode โ†’ Operation mode (data, benchmark, agent)
  • โ€”--samples โ†’ Number of samples to process (default: 10)
๐Ÿ™๏ธ Data Mode Options
  • โ€”--urban โ†’ Focus on urban environments
  • โ€”--no-indoor โ†’ Exclude indoor scenes
๐Ÿ“Š Benchmark Mode Options
  • โ€”--models โ†’ AI model to use (e.g., `gpt-4o`, `claude-3`, `gemini-pro`)
๐Ÿค– Agent Mode Options
  • โ€”--model โ†’ AI model for agentic analysis
  • โ€”--steps โ†’ Number of reasoning steps (default: 5)

๐ŸŽฏ Supported Models

<div align="center">

ProviderModelsStatus
๐Ÿ”ต OpenAIGPT-4o, GPT-4, GPT-3.5-turboโœ… Active
๐ŸŸฃ AnthropicClaude-3-opus, Claude-3-sonnet, Claude-3-haikuโœ… Active
๐Ÿ”ด GoogleGemini-2.5-pro, Gemini-pro, Gemini-pro-visionโœ… Active

</div>


๐Ÿ“‹ Requirements

Prerequisites: - ๐Ÿ Python 3.8+ - ๐Ÿ“ฆ UV package manager - ๐Ÿ”‘ Valid API keys for desired AI providers

๐Ÿ”ง Installation

<table> <tr> <td>

1๏ธโƒฃ Clone the repository

bash
git clone <repository-url>

2๏ธโƒฃ Navigate to project directory

bash
cd simple_G_ai_bot

</td> <td>

3๏ธโƒฃ Create .env file with your API keys

bash
touch .env
# Add your API keys

4๏ธโƒฃ Install dependencies

bash
uv sync

</td> </tr> </table>

5๏ธโƒฃ Run the bot with desired mode and options! ๐ŸŽ‰


๐Ÿ’ก Examples

๐Ÿ—๏ธ Basic Dataset Generation

bash
python main.py --mode data --samples 20

๐ŸŒ† Urban Scene Analysis

bash
python main.py --mode data --samples 30 --urban --no-indoor

โš”๏ธ Model Comparison

bash
# GPT-4o Analysis
python main.py --mode benchmark --models gpt-4o --samples 10

# Claude-3 Analysis  
python main.py --mode benchmark --models claude-3-opus --samples 10

๐Ÿง  Advanced Agentic Workflow

bash
python main.py --mode agent --model gemini-2.5-pro --steps 15 --samples 3

๐Ÿ” Security Note

โš ๏ธ Important: Never commit your .env file to version control. Add .env to your .gitignore file to keep your API keys secure.

<div align="center">

๐Ÿ“œ License

MIT License - see LICENSE file for details.


<img src="https://img.shields.io/badge/Made%20with-โค๏ธ-red.svg" alt="Made with love"> <img src="https://img.shields.io/badge/AI%20Powered-๐Ÿค–-blue.svg" alt="AI Powered"> <img src="https://img.shields.io/badge/Open%20Source-๐Ÿ’š-green.svg" alt="Open Source">

โญ Star this repo if you find it useful!

</div>