Skip to main content

Semi-Agentic Terminal AI assistant with shell error detection and debugging via Telegram

Project description

Latest Release

🧠 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


🚀 Installation

  1. 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
  1. 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:

  • 🔐 .env configuration 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

neuronet_ai_cognitiveshell-0.2.5.tar.gz (19.9 kB view details)

Uploaded Source

Built Distribution

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

neuronet_ai_cognitiveshell-0.2.5-py3-none-any.whl (19.4 kB view details)

Uploaded Python 3

File details

Details for the file neuronet_ai_cognitiveshell-0.2.5.tar.gz.

File metadata

File hashes

Hashes for neuronet_ai_cognitiveshell-0.2.5.tar.gz
Algorithm Hash digest
SHA256 eb6e3a6f4c1d75ca0ab33cb426d57d318e5f39e0c314adabfb8a925b69c60c15
MD5 fd7a9403923f3fd64573ddb4e763b9de
BLAKE2b-256 bd4e2d298213b62459afe0a0fe42bdeb4a2aecd9a8cbf4c14dadb9f41dbcaa30

See more details on using hashes here.

Provenance

The following attestation bundles were made for neuronet_ai_cognitiveshell-0.2.5.tar.gz:

Publisher: python-publish.yml on muhammad-robitulloh/NeuroNet-AI-NodeSystem_Cognitive-Shell.v2.0

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file neuronet_ai_cognitiveshell-0.2.5-py3-none-any.whl.

File metadata

File hashes

Hashes for neuronet_ai_cognitiveshell-0.2.5-py3-none-any.whl
Algorithm Hash digest
SHA256 8f9a8a09d16ecc224e4f3ae2587f134e9745ee1471aed44a1b4174329fd8db48
MD5 60c6363db411e98320666b87398d13ce
BLAKE2b-256 d067d2746fff9d69ae3b3faac88143810deb05b74c510b52973224f2fa42254d

See more details on using hashes here.

Provenance

The following attestation bundles were made for neuronet_ai_cognitiveshell-0.2.5-py3-none-any.whl:

Publisher: python-publish.yml on muhammad-robitulloh/NeuroNet-AI-NodeSystem_Cognitive-Shell.v2.0

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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