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.tar.gz (5.5 kB view details)

Uploaded Source

Built Distributions

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

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

Uploaded Python 3

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: trollos-1.0.tar.gz
  • Upload date:
  • Size: 5.5 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.tar.gz
Algorithm Hash digest
SHA256 4a8a8336ff5615cb1cf9514113666be259fe0485ea492b3642091ea04868f4b9
MD5 f7ec2bef2a69993600552b8662380ac0
BLAKE2b-256 03593a0fe27ca0ed36543e394b3ece2abe17f23474d35d1b1bef53ded29bf440

See more details on using hashes here.

File details

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

File metadata

  • Download URL: trollos-1.0.0-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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 08a63bb7a4bcfcd6368a9d8fd10357d71b0783a412405201d0a9867bbfa19497
MD5 b8cca881f8abad3bedd6aa599f48db09
BLAKE2b-256 8ac526bae8790f93103a510b1d78a343b3ad9d3cbee23fb8c6e1605b1c4655e8

See more details on using hashes here.

File details

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

File metadata

  • Download URL: trollos-1.0-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-py3-none-any.whl
Algorithm Hash digest
SHA256 c5b467230c92bcb64bdc087bba46ad571ebbcf09a0352e8c9edb38e8f08dfbee
MD5 ceb9fdbf295edd832b129612f2b67cd1
BLAKE2b-256 7f1b55613f3151e40834ae8c5ce967e73a5369e0477e2a05c6b76d8fd7eaf32a

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