Gemma 3 R1984 4B

🚀 Gemma3-R1984-4B

Gemma3-R1984-4B is a powerful Agentic AI platform built on Google's Gemma-3-4B model, offering multimodal processing, deep research, and long - context handling.

🚀 Quick Start

Gemma3-R1984-4B is a robust Agentic AI platform built on Google’s Gemma-3-4B model. It integrates state - of - the - art deep research via web search with multimodal file processing—including images, videos, and documents—and handles long contexts up to 8,000 tokens. Designed for local deployment on independent servers using NVIDIA L40s, L4, A - 100(ZeroGPU) GPUs, it provides high security, prevents data leakage, and delivers uncensored responses.

✨ Features

Multimodal Processing

Supports multiple file types such as images (PNG, JPG, JPEG, GIF, WEBP), videos (MP4), and documents (PDF, CSV, TXT).

Deep Research (Web Search)

Automatically extracts keywords from user queries and utilizes the SERPHouse API to retrieve up to 20 real - time search results. The model incorporates multiple sources by explicitly citing them in the response.

Long Context Handling

Capable of processing inputs up to 8,000 tokens, ensuring comprehensive analysis of lengthy documents or conversations.

Robust Reasoning

Employs extended chain - of - thought reasoning for systematic and accurate answer generation.

Secure Local Deployment

Operates on independent local servers using NVIDIA L40s GPUs to maximize security and prevent information leakage.

Experience the Power of Gemma3-R1984-4B

• ✅ Agentic AI Platform: An autonomous system designed to make intelligent decisions and act independently.
• ✅ Reasoning & Uncensored: Delivers clear, accurate, and unfiltered responses by harnessing advanced reasoning capabilities.
• ✅ Multimodal & VLM: Seamlessly processes and interprets multiple input types—text, images, videos—empowering versatile applications.
• ✅ Deep - Research & RAG: Integrates state - of - the - art deep research and retrieval - augmented generation to provide comprehensive, real - time insights.

Cutting - Edge Hardware for Maximum Security

Gemma3-R1984-4B is engineered to operate on a dedicated NVIDIA L40s GPU within an independent local server environment. This robust setup not only guarantees optimal performance and rapid processing but also enhances security by isolating the model from external networks, effectively preventing information leakage. Whether handling sensitive data or complex queries, our platform ensures that your information remains secure and your AI interactions remain uncompromised.

📦 Installation

Requirements

Ensure you have Python 3.8 or higher installed. The model relies on several libraries:

• PyTorch (with bfloat16 support)
• Transformers
• Gradio
• OpenCV (opencv - python)
• Pillow (PIL)
• PyPDF2
• Pandas
• Loguru
• Requests

Install dependencies using pip:

pip install torch transformers gradio opencv-python pillow PyPDF2 pandas loguru requests

Environment Variables

Set the following environment variables before running the model:

• SERPHOUSE_API_KEY: Your SERPHouse API key for web search functionality. Example:

  export SERPHOUSE_API_KEY="your_api_key_here"
  

• MODEL_ID: (Optional) The model identifier; default is VIDraft/Gemma - 3 - R1984 - 4B.
• MAX_NUM_IMAGES: (Optional) Maximum number of images allowed per query (default is 5).

💻 Usage Examples

Server Example

You can deploy the model server locally using the provided Gradio code. Make sure your server is accessible at your designated URL.

Client Request Example

Below is an example of how to interact with the model using an HTTP API call:

import requests
import json

# Replace with your server URL and token
url = "http://<your-server-url>:8000/v1/chat/completions"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer your_token_here"
}

# Construct the message payload
messages = [
    {"role": "system", "content": "You are a powerful AI assistant."},
    {"role": "user", "content": "Compare the contents of two PDF files."}
]

data = {
    "model": "VIDraft/Gemma-3-R1984-4B",
    "messages": messages,
    "temperature": 0.15
}

# Send the POST request to the server
response = requests.post(url, headers=headers, data=json.dumps(data))

# Print the response from the model
print(response.json())

📚 Documentation

Use Cases

• Fast - response conversational agents
• Deep research and retrieval - augmented generation (RAG)
• Document comparison and detailed analysis
• Visual question answering from images and videos
• Complex reasoning and research - based inquiries

Supported File Formats

• Images: PNG, JPG, JPEG, GIF, WEBP
• Videos: MP4
• Documents: PDF, CSV, TXT

Model Details

Running the Model

Gemma3-R1984-4B comes with a Gradio - based multimodal chat interface. To run the model locally:

1. Clone the Repository: Ensure you have the repository containing the model code.
2. Launch the Application: Execute the main Python file:

   python your_filename.py
   

   This will start a local Gradio interface. Open the provided URL in your browser to interact with the model.

Important Deployment Notice

For optimal performance, it is highly recommended to clone the repository using the following command. This model is designed to run on a server equipped with at least an NVIDIA L40s, L4, A100(ZeroGPU) GPU. The minimum VRAM requirement is 24GB, and VRAM usage may temporarily peak at approximately 82GB during processing.

git clone https://huggingface.co/spaces/VIDraft/Gemma-3-R1984-4B

📄 License

mit(Agentic AI) / gemma(gemma - 3 - 4B)