________ __________.____    ._______   ____.___________    _______   
\_____  \\______   \    |   |   \   \ /   /|   \_____  \   \      \  
 /   |   \|    |  _/    |   |   |\   Y   / |   |/   |   \  /   |   \ 
/    |    \    |   \    |___|   | \     /  |   /    |    \/    |    \
\_______  /______  /_______ \___|  \___/   |___\_______  /\____|__  /
        \/       \/        \/                          \/         \/ 

A lightweight, high-performance AI assistant powered by Google's Gemini API

Oblivion is a modern C++ application that brings the power of large language models directly to your desktop without the computational overhead of running models locally. Designed with performance and efficiency in mind, it provides seamless AI assistance while maintaining minimal resource usage.

• Unnecessary API calls canceled.
• TTS integratred

• Operating System: Windows 10/11 (Linux support in development)
• Compiler: GCC with C++17 support
• Internet Connection: Required for API communication
• Gemini API Key: Get your free key here

1. Clone the Repository

   git clone https://github.com/Iftikha/Oblivion.git
   cd Oblivion

2. Install libcurl

   • Download from curl.se/windows
   • Extract to C://libcurl/
   • Copy DLL files to project directory

3. Configure API Key To configure API-KEY, create .env and paste the following:

   API_KEY=PASTE YOUR API KEY HERE

4. Create Required Directories

   mkdir history
   touch history/history.txt

5. Build and Run

   make build
   make run

// Initialize Oblivion
Engine engine;
engine.init("your-api-key-here");

// Start conversation
cout << "You: Hello Oblivion";
string response = engine.sendRequest("Hello Oblivion");
cout << "Oblivion: " << response << endl;

# Switch to new branch
git checkout v3.0
# Build
make build

# Run
make run

=== OBLIVION - AI Assistant ===
Model: gemini-pro
Welcome, User!

You: > run chrome
Oblivion: Executing system command...
[ Chrome launched ]

You: Write a Python script to print numbers 1-10
Oblivion: Here's a simple script:

for i in range(1, 11):
    print(i)

You: /bye
---

## 📁 Project Structure

Oblivion/ | ├── main.cpp # Application entry point ├── audio_output/ # Saves the TTS audio files ├── include/ │ ├── json.hpp # JSON library (included) │ ├── Conversation.hpp # History class header │ ├── Conversation.cpp # History management │ ├── CommandParser.hpp # Parses and Executes Commands Class │ ├── CommandParser.cpp # Parses and executes commands │ ├── ResponseHandler.hpp # Manages the prompt Class │ ├── ResponseHanlder.cpp # Manages Prompt │ ├── Engine.hpp # Engine class header │ └── Engine.cpp # API communication ├── history/ │ └── history.txt # Conversation storage ├── commands/ │ └── commands.json # Conversation storage ├── Makefile # Build configuration └── README.md # This file

---

## 🔧 Configuration

### Build Options
```makefile
# Build exe file
make build

# Run the exe file
make run

# Clean build files
make clean

• Model Selection: Supports gemini-pro, gemini-2.0-flash
• Response Length: Configurable token limits
• History Size: Adjustable conversation memory

We welcome contributions!

• Follow C++17 standards
• Include unit tests for new features
• Update documentation for API changes
• Ensure cross-platform compatibility

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

Iftikhar Ahmed
Software Engineer & AI Enthusiast

• GitHub: @khaixu30
• Email: [email protected]

• Google LLC - For the powerful Gemini API
• nlohmann - For the excellent JSON library
• curl team - For reliable HTTP client library
• C++ Community - For continuous language improvements

• ✅ Core chat functionality
• ✅ Conversation history
• ✅ Gemini API integration
• ✅ Windows support

• ✅ System commands execution

• 🔄 TTS Integrated

• 🔄 Cross-platform support
• 🔄 Plugin architecture
• 🔄 Advanced automation

⭐ Star this repository if you find it helpful!

Made with ❤️ and C++