Skip to content

AllLiveSupport/ROT-Systems

Repository files navigation

🌍 ROT Systems - Storyteller Guide

πŸš€ The Ultimate AI-Powered Local Assistant & World Clock Interface


Live Demo GitHub stars License Buy Me a Coffee



✨ 4 Languages β€’ πŸ”„ Real-Time Weather & Time β€’ πŸ“ Live AI Chat β€’ πŸ›‘οΈ Secure & Free β€’ πŸ–ΌοΈ Glassmorphism UI



πŸ“– Overview

ROT Systems is a modern, responsive, and completely client-side AI city guide built on React and Vite. Experience time and culture around the world with an integrated Gemini AI interface. Whether you need a local history dive, a translation, or a local poetβ€”ROT does it all.

Unlike traditional platforms, this tool is built to let YOU bring your own API key, keeping your data entirely private, free, and completely within your control.


🌟 Key Features

πŸš€ AI Integration at its Core

  • Bring Your Own Key (BYOK): Use your own Google Gemini API key safely. Keys are stored locally on your device and are never sent to external servers.
  • Dynamic Persona Prompts: Switch from a "Historian" to a "Foodie" to a "Local Gossip" in seconds.
  • Custom AI Models: Supports the latest models (gemini-2.5-flash-lite, gemini-3.1-pro-preview) and lets you define custom model endpoints.

πŸ›‘οΈ Privacy First

  • Zero Backend: Nothing is tracked. No user accounts, no telemetry, no tracking scripts. All data flows directly from your device to Google AI Studio.
  • Client-Side Only: Powered entirely by React.
  • Open Source: Verify everything yourself.

🎨 Modern & Immersive Interface

  • Dynamic Glassmorphism UI: Background and UI elements adapt and respond to real-world time of day.
  • Multi-Lingual Capabilities: Native support for English, Turkish, Spanish, and Russian. Everything changes interactively without refreshing.

πŸ“Έ Visual Tour

🌍 Global Clock Interface πŸ’¬ Live AI Chat & Storyteller
Main City View Chat UI
Real-time clocks with glassmorphism UI & dynamic backgrounds Interact with the local storyteller persona
βš™οΈ Private Settings (BYOK) πŸ›‘οΈ Built-in Privacy Focus
Settings Manager Privacy Policy Modal
Manage API keys, models, and multi-language support (TR, EN, ES, RU) Fully transparent, zero-backend architecture


πŸ› οΈ Quick Start & Installation Guide

You can test this project immediately by spinning up the development environment.

  1. Download the Code:

    • Clone this repository or download the ZIP file and extract it.
    • git clone https://github.com/AllLiveSupport/ROT-Systems.git
  2. Install Dependencies:

    • Navigate to the folder and run:
      cd ROT-Systems
      npm install
  3. Start Development Server:

    • npm run dev
    • Open your browser to http://localhost:5173.
  4. Add your Gemini API Key:

    • Click the βš™οΈ Settings icon at the bottom of the screen.
    • Input your API key (get one free from Google AI Studio).
    • Save and start chatting!

⚠️ Disclaimer

Caution

Legal Notice: This tool is provided for educational and personal purposes only.

  • πŸ€– AI Output: ROT Systems utilizes Google Gemini. Responses are AI-generated and may occasionally be inaccurate.
  • βš–οΈ Terms of Service: You are solely responsible for complying with Google API's Terms of Service when using your own API key.
  • πŸ‘€ Liability: The authors and contributors are not responsible for any misuse.

πŸ“œ License

This project is licensed under the MIT License. See the LICENSE file for more details.


❀️ Support the Project

If this tool inspired you or helped you explore the world, consider supporting its development!

Buy Me a Coffee GitHub

About

🌍 An open-source, zero-backend AI city guide & world clock. Powered by React, Vite, and Google Gemini API (BYOK).

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages