• Overview
• Features
• Architecture
• Installation
  • Standard Installation
  • Termux Installation
• Configuration
• Usage
  • CLI Mode
  • Telegram Bot Mode
• Commands Reference
• Screenshots
• API Integration
• Contributing
• Troubleshooting
• Changelog
• License
• Developer

NeuraX is an open-source AI assistant tool that seamlessly integrates with Perplexity AI, offering both a sophisticated Command Line Interface (CLI) and a fully-featured Telegram bot. Developed by Alex Butler from the Vritra Security Organization, NeuraX is designed for developers, researchers, and AI enthusiasts who want powerful AI capabilities at their fingertips.

• 🚀 Dual Interface: Choose between CLI for quick queries or Telegram for on-the-go access
• 🧠 Powered by Perplexity AI: Leverages cutting-edge AI technology
• 🔒 Secure Configuration: Safe storage of API keys and tokens
• 🌍 Cross-Platform: Works on Linux, macOS, Windows, and Android (Termux)
• 📦 Modular Design: Professional, maintainable codebase
• 🎨 Beautiful Interface: Colorful CLI with intuitive commands

• Interactive CLI Chat Interface with rich color output
• Telegram Bot Integration with full command support
• Persistent Configuration Management with secure storage
• Context-Aware Conversations with chat history
• Multi-User Support for Telegram bot
• Cross-Platform Compatibility (Linux, macOS, Windows, Android)
• Professional Error Handling and logging
• Signal Handling for graceful shutdowns

• Asynchronous Operations for optimal performance
• Modular Architecture for easy maintenance
• Configuration Validation with helpful error messages
• Interactive and Inline Configuration options
• Real-time Status Monitoring
• Comprehensive Help System

NeuraX follows a modular architecture pattern:

NeuraX/
├── README.md                 # Project documentation
├── requirements.txt          # Python dependencies
├── neurax.py                # Main application entry point
├── LICENSE                  # MIT License file
└── modules/
    ├── __init__.py          # Package initialization and exports
    ├── ai_client.py         # Perplexity AI client implementation
    ├── colors.py            # ANSI color codes and banner
    ├── config.py            # Configuration management system
    ├── telegram_bot.py      # Telegram bot implementation
    └── utils.py             # Utility functions and helpers

• neurax.py: Main entry point with argument parsing and mode selection
• ai_client.py: Handles communication with Perplexity AI API
• colors.py: Provides ANSI color codes and the NeuraX banner
• config.py: Manages persistent configuration storage and retrieval
• telegram_bot.py: Complete Telegram bot implementation with async handlers
• utils.py: Common utility functions for UI and system operations

# Clone the repository
git clone https://github.com/VritraSecz/NeuraX.git

# Navigate to the project directory
cd NeuraX

# Install Python dependencies
pip install -r requirements.txt

# Verify Installation
python neurax.py --help

# Update packages and install dependencies
pkg update && pkg upgrade
pkg install git python

# Clone the repository
git clone https://github.com/VritraSecz/NeuraX.git

# Navigate to the project directory
cd NeuraX

# Install Python dependencies
pip install -r requirements.txt

# Check Installation
python neurax.py --about

• Python 3.7+
• requests >= 2.31.0
• python-telegram-bot == 21.5 (for bot functionality)
• pytz >= 2024.1 (for timezone support)
• colorama >= 0.4.6 (for cross-platform colors)

NeuraX stores configurations in ~/.config-vritrasecz/neurax-config.json for persistent settings across sessions.

1. Perplexity API Key

   • Get your API key from Perplexity AI Settings
   • Configure: python neurax.py --api

2. Telegram Bot Token (Optional - only for bot functionality)

   • Create a bot via @BotFather on Telegram
   • Configure: python neurax.py --token

# Interactive API key configuration
python neurax.py --api

# Direct API key configuration
python neurax.py --api sk-proj-your-api-key-here

# Interactive Telegram token configuration
python neurax.py --token

# Direct Telegram token configuration
python neurax.py --token 1234567890:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

# View current configuration
python neurax.py --config

Start an interactive chat session:

python neurax.py

CLI Commands during chat:

• exit, quit, or bye - Exit chat mode
• clear - Clear chat history
• help - Show available commands

1. Configure the bot token:

   python neurax.py --token

2. Start the bot:

   python neurax.py --bot

Telegram Bot Commands:

• /start - Welcome message and bot introduction
• /help - Show available commands
• /clear - Clear your chat history
• /about - Information about the bot and developer
• /status - Check bot status and statistics

NeuraX uses the Perplexity AI API for generating responses:

• Model: sonar
• Endpoint: https://api.perplexity.ai/chat/completions
• Features: Context-aware conversations, chat history management
• Error Handling: Comprehensive error handling for network and API issues

The Telegram bot implementation includes:

• Asynchronous Operations for better performance
• Per-User Session Management for isolated conversations
• Rich Command Support with markdown formatting
• Error Recovery and logging
• Multi-User Concurrent Support

• We welcome contributions from the community! Here's how you can help:

• 🐛 Report Bugs: Use the Issues tab
• 💡 Suggest Features: Submit feature requests
• 🔧 Code Contributions: Fork, develop, and submit pull requests
• 📖 Documentation: Improve documentation and examples
• 🌍 Translations: Help translate NeuraX to other languages

1. 🍴 Fork the repository
2. 🌿 Create a feature branch (git checkout -b feature/AmazingFeature)
3. 💾 Commit your changes (git commit -m 'Add some AmazingFeature')
4. 📤 Push to the branch (git push origin feature/AmazingFeature)
5. 🔄 Open a Pull Request

• Follow PEP 8 Python style guide
• Use meaningful variable and function names
• Add docstrings to functions and classes
• Include type hints where appropriate
• Write comprehensive error handling

1. Import Errors

   # Solution: Install missing dependencies
   pip install -r requirements.txt

2. API Key Issues

   # Solution: Reconfigure API key
   python neurax.py --api

3. Telegram Bot Not Responding

   # Solution: Check token and restart bot
   python neurax.py --config
   python neurax.py --token

4. Permission Errors

   # Solution: Check file permissions
   chmod +x neurax.py

• 📖 Check the documentation
• 🐛 Search existing issues
• 💬 Join our Telegram community
• 📧 Contact the developer (see Developer section)

• ✔ Initial release
• ✔ CLI chat interface
• ✔ Telegram bot integration
• ✔ Perplexity AI integration
• ✔ Configuration management
• ✔ Cross-platform support
• ✔ Modular architecture

• 🔄 Multiple AI provider support
• 📊 Usage statistics and analytics
• 🎨 Customizable themes and colors
• 📱 Web interface
• 🔐 Enhanced security features

This project is licensed under the MIT License - see the LICENSE file for details.

MIT License

Copyright (c) 2025 Alex Butler (Vritra Security Organization)

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.