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

⚙️ 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.3.tar.gz (19.2 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.3-py3-none-any.whl (18.4 kB view details)

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for neuronet_ai_cognitiveshell-0.2.3.tar.gz
Algorithm Hash digest
SHA256 e7b80a5d2f9193a02907a7213a141462080242d75e86dc277900366aeebd90c6
MD5 88c89969bac519cd0217c9c600e1fc23
BLAKE2b-256 9c85308ddff0c5bd3d58769aca73ddcb964e9c5efed8eab940755bd6146d6c74

See more details on using hashes here.

Provenance

The following attestation bundles were made for neuronet_ai_cognitiveshell-0.2.3.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.3-py3-none-any.whl.

File metadata

File hashes

Hashes for neuronet_ai_cognitiveshell-0.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 aab2129a93a1fff428b145a8517cf4c597b950f80218676a2e923118a25abeab
MD5 4539bdbba998bbbd022168e6a6dc5337
BLAKE2b-256 45e5d5eeea03275890fbe2e63a553108228089ebfc264a48b2d7e8e321f853ec

See more details on using hashes here.

Provenance

The following attestation bundles were made for neuronet_ai_cognitiveshell-0.2.3-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