Semi-Agentic Terminal AI assistant with shell error detection and debugging via Telegram
Project description
🧠 NeuroNet AI Node System: Cognitive Shell v2.0
A semi-agentic AI terminal shell that thinks, suggests, and acts — from detecting terminal errors to auto-fixing them using AI, all running on lightweight environments like Termux or Google Cloud Shell.
Terminal meets AI. Debugging gets intelligent.
✨ Features
- ✅ Real-time log monitoring
- 🔍 Error detection via keyword and pattern recognition
- 🤖 LLM-powered suggestions via OpenRouter or custom API
- 🔁 Optional auto-execution of AI-recommended fixes
- 💬 Telegram Bot Integration (send/receive terminal commands via Telegram)
- 📱 Optimized for low-resource devices like Android Termux or cloud shells
📦 Requirements
- Python
>=3.10 pexpect,requests,re,os,time- Telegram bot token (you can get from @BotFather)
- A free OpenRouter API key (https://openrouter.ai/)
🚀 Installation
-
Install dependencies:
tested on
Termux
pkg update && pkg upgrade
pkg install python git
git clone https://github.com/muhammad-robitulloh/NeuroNet-AI-NodeSystem_Cognitive-Shell.v2.0.git
cd NeuroNet-AI-NodeSystem_Cognitive-Shell.v2.0
pip install -r requirements.txt
python quick_start.py
python cognitive_shell/__main__.py
- Install via PyPI(Python Package Index)
pip install neuronet-ai-cognitiveshell
quickstart
cognitiveshell
⚙️ Under Development
The current version of Cognitive Shell is still under active development.
Planned improvements include:
- 🔐
.envconfiguration for API keys and tokens (Telegram, LLM, etc.) - 🧠 Multi-model support (switching between OpenRouter, local LLMs, etc.)
- 💬 Customizable prompt templates per user
- 📂 Logging and error history system
- 📦 Packaged CLI setup with one-liner installer
This early MVP is functional but minimal — perfect for testing agentic capabilities in lightweight environments like Termux or remote shells.
Expect frequent updates and breaking changes during this phase. Contributions and feedback are welcome!
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
Built Distribution
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 neuronet_ai_cognitiveshell-0.2.6.tar.gz.
File metadata
- Download URL: neuronet_ai_cognitiveshell-0.2.6.tar.gz
- Upload date:
- Size: 20.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
699bb13360492535407bb8e7e51df51b3dc89b60acb42cc7a3548b6c9b5d574c
|
|
| MD5 |
79f282e3c60d8c45a0ddb54022840773
|
|
| BLAKE2b-256 |
d6552b4394a99d79c810d243547bc09103358744710b542475ce95d0e19a9143
|
Provenance
The following attestation bundles were made for neuronet_ai_cognitiveshell-0.2.6.tar.gz:
Publisher:
python-publish.yml on muhammad-robitulloh/NeuroNet-AI-NodeSystem_Cognitive-Shell.v2.0
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
neuronet_ai_cognitiveshell-0.2.6.tar.gz -
Subject digest:
699bb13360492535407bb8e7e51df51b3dc89b60acb42cc7a3548b6c9b5d574c - Sigstore transparency entry: 251734020
- Sigstore integration time:
-
Permalink:
muhammad-robitulloh/NeuroNet-AI-NodeSystem_Cognitive-Shell.v2.0@9dd1bc1e6fa1376b1c50199478a93b7799b504f2 -
Branch / Tag:
refs/tags/0.2.6 - Owner: https://github.com/muhammad-robitulloh
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
python-publish.yml@9dd1bc1e6fa1376b1c50199478a93b7799b504f2 -
Trigger Event:
release
-
Statement type:
File details
Details for the file neuronet_ai_cognitiveshell-0.2.6-py3-none-any.whl.
File metadata
- Download URL: neuronet_ai_cognitiveshell-0.2.6-py3-none-any.whl
- Upload date:
- Size: 19.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
524ecbbd8b90012c1495c613123d0a20dba68d15ceb5c34b0692b419c5dc557e
|
|
| MD5 |
0ceea7728c6e3a69281b7711552f01d5
|
|
| BLAKE2b-256 |
f3b27d8acc2ffd12ac02ac7386e3488bbc76d7600d1d5b97c8024c868fd4c0e1
|
Provenance
The following attestation bundles were made for neuronet_ai_cognitiveshell-0.2.6-py3-none-any.whl:
Publisher:
python-publish.yml on muhammad-robitulloh/NeuroNet-AI-NodeSystem_Cognitive-Shell.v2.0
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
neuronet_ai_cognitiveshell-0.2.6-py3-none-any.whl -
Subject digest:
524ecbbd8b90012c1495c613123d0a20dba68d15ceb5c34b0692b419c5dc557e - Sigstore transparency entry: 251734025
- Sigstore integration time:
-
Permalink:
muhammad-robitulloh/NeuroNet-AI-NodeSystem_Cognitive-Shell.v2.0@9dd1bc1e6fa1376b1c50199478a93b7799b504f2 -
Branch / Tag:
refs/tags/0.2.6 - Owner: https://github.com/muhammad-robitulloh
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
python-publish.yml@9dd1bc1e6fa1376b1c50199478a93b7799b504f2 -
Trigger Event:
release
-
Statement type: