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:
🛠️ 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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4a8a8336ff5615cb1cf9514113666be259fe0485ea492b3642091ea04868f4b9
|
|
| MD5 |
f7ec2bef2a69993600552b8662380ac0
|
|
| BLAKE2b-256 |
03593a0fe27ca0ed36543e394b3ece2abe17f23474d35d1b1bef53ded29bf440
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
08a63bb7a4bcfcd6368a9d8fd10357d71b0783a412405201d0a9867bbfa19497
|
|
| MD5 |
b8cca881f8abad3bedd6aa599f48db09
|
|
| BLAKE2b-256 |
8ac526bae8790f93103a510b1d78a343b3ad9d3cbee23fb8c6e1605b1c4655e8
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c5b467230c92bcb64bdc087bba46ad571ebbcf09a0352e8c9edb38e8f08dfbee
|
|
| MD5 |
ceb9fdbf295edd832b129612f2b67cd1
|
|
| BLAKE2b-256 |
7f1b55613f3151e40834ae8c5ce967e73a5369e0477e2a05c6b76d8fd7eaf32a
|