Skip to main content

AI-powered retro UNIX-style troll terminal using Llama3

Project description

🟩 TrollOS – AI Terminal Troll Engine A realistic terminal OS that roasts your commands using a local AI model (Llama3).

Built with Python, Textual TUI, and Ollama.

🚀 Features

✔ Live system stats panel

✔ AI-generated troll responses

✔ Fake kernel panics & system logs

✔ Glitch effects + ASCII corruption

✔ Local + offline (NO API keys)

✔ Color-accurate RichLog rendering

✔ Cross-platform: Windows / Linux / Mac

📂 Project Structure TrollOS/ ├── src/ │ └── trollos.py ├── assets/ │ └── screenshot.png (optional) ├── requirements.txt ├── README.md └── .gitignore

⚙️ Requirements

Python 3.10+

Ollama installed on system

Llama3 model downloaded

Windows Terminal / macOS Terminal / Linux shell

Runs on CPU or GPU

📥 Installation Guide (FULL) 1️⃣ Install Python

Download Python 3.10+ https://www.python.org/downloads/

2️⃣ Install Ollama

Download from: https://ollama.com/download

After installation, run:

ollama serve

This starts the local AI server.

3️⃣ Download Llama3 model

Run:

ollama pull llama3

(Recommended: 8B size)

4️⃣ Clone This Repository git clone https://github.com/MISHRA1007/TrollOS.git cd TrollOS

5️⃣ Install Python Dependencies pip install -r requirements.txt

▶️ Running TrollOS

In the project folder:

python src/trollos.py

The full-screen UI will launch inside your terminal.

🎮 How to Use

Type any command

Hit ENTER

Llama3 generates a troll response

Fake kernel logs appear

“sudo rm -rf /” triggers chaos mode

Stats update in real-time

Scroll logs with mouse / wheel

🖼️ Screenshots

assets/screenshot.png

Example:

TrollOS Screenshot

🛠️ Technologies Used

Python

Textual (Terminal UI Framework)

Rich (Color + formatting)

Ollama Llama3 (Local LLM)

📄 License

MIT License Free to use, modify, distribute.

🤝 Contributing

PRs are welcome. Submit issues for bugs & feature requests.

🧑‍💻 Author

TrollOS – Made by SAURABH Powered by chaos + local AI.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

trollos-1.0.1.tar.gz (5.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

trollos-1.0.1-py3-none-any.whl (5.9 kB view details)

Uploaded Python 3

File details

Details for the file trollos-1.0.1.tar.gz.

File metadata

  • Download URL: trollos-1.0.1.tar.gz
  • Upload date:
  • Size: 5.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.0

File hashes

Hashes for trollos-1.0.1.tar.gz
Algorithm Hash digest
SHA256 1ee76c571bebdd8744c03901e80ba6e56f8da16a146e6aa988d093646266f430
MD5 620d7fd1210a19cb1007c4213ef5e1db
BLAKE2b-256 13894533cabd31ed9f0090f961450763406c281b8940fdcd668bfb172be6c6c9

See more details on using hashes here.

File details

Details for the file trollos-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: trollos-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 5.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.0

File hashes

Hashes for trollos-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 d3c71164d36381c12945455a531010c1bd619ea64e44165961e5677f46f5ad9a
MD5 2bf859ccde42a28fdd6a310e47b98fff
BLAKE2b-256 4ec1d805f86800d3f3c3648eeff9cf78d67373696162f7d57a4ffc310eeadf18

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page