Skip to main content

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

Project description

PyPI Downloads Build Status License Last Commit

🧠 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.6.tar.gz (20.4 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.6-py3-none-any.whl (19.7 kB view details)

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for neuronet_ai_cognitiveshell-0.2.6.tar.gz
Algorithm Hash digest
SHA256 699bb13360492535407bb8e7e51df51b3dc89b60acb42cc7a3548b6c9b5d574c
MD5 79f282e3c60d8c45a0ddb54022840773
BLAKE2b-256 d6552b4394a99d79c810d243547bc09103358744710b542475ce95d0e19a9143

See more details on using hashes here.

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

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.6-py3-none-any.whl.

File metadata

File hashes

Hashes for neuronet_ai_cognitiveshell-0.2.6-py3-none-any.whl
Algorithm Hash digest
SHA256 524ecbbd8b90012c1495c613123d0a20dba68d15ceb5c34b0692b419c5dc557e
MD5 0ceea7728c6e3a69281b7711552f01d5
BLAKE2b-256 f3b27d8acc2ffd12ac02ac7386e3488bbc76d7600d1d5b97c8024c868fd4c0e1

See more details on using hashes here.

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

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