🛠️ HelperTools

Version: 1.0.0
Platform: Windows (PowerShell/CMD) | Coming Soon: Linux, macOS

📖 Overview

HelperTools is a powerful terminal extension toolkit designed to make developers' lives easier. Whether you're building games, web applications, or desktop software, HelperTools provides intuitive commands and AI-powered assistance to streamline your workflow.

What is HelperTools?

HelperTools is a command-line extension system that runs on any device (currently Windows, with Linux and macOS support coming soon). It integrates seamlessly with your terminal and provides:

Simple, memorable commands for complex tasks
AI-powered assistance through HelperToolsAI (based on Brahma AI)
Dual control modes: Desktop GUI (Python) or Web Interface (Node.js)
Low resource usage - optimized for performance
Extensible architecture - easily add your own commands

✨ Features

Core Features

✅ Easy File Management - Create, edit, delete files with half the commands
✅ Quick Commands - Intuitive command structure for rapid development
✅ Low Memory Usage - Efficient resource management (except when using AI features)
✅ AI Integration - HelperToolsAI for intelligent assistance
✅ Dual Control - Choose between Desktop App or Web Interface
✅ Smart Installation - Automatically detects low disk space and installs on alternate drives
✅ Command History - Track and review all executed commands
✅ Configuration Management - Easily customize settings

AI Features (HelperToolsAI)

🤖 Voice and text interaction
🎯 Context-aware assistance
📝 Code generation and debugging
🌐 Web browsing and research
📊 File processing and analysis
🏠 Smart home integration
📧 Message automation
🎮 Game management
And much more!

Coming Soon

📱 Mobile device support
🐧 Linux compatibility
🍎 macOS compatibility
🔌 Plugin system for custom extensions
🌍 Multi-language support
☁️ Cloud synchronization

📦 Installation

Prerequisites

Python 3.8+ (Required)
Node.js 16+ (Optional, for web server features)
Git (Optional, for updates)

Quick Install

Clone or download HelperTools to your desired location:

git clone https://github.com/FallenNightA/HelperTools.git
cd HelperTools

Add HelperTools to your PATH (User Variables):
- Open Environment Variables settings
- Under User Variables, find or create Path
- Add the full path to your HelperTools folder (e.g., F:\HelperTools)
- Click OK to save
Install dependencies:
```
hts
install
```
Note: The installer automatically detects low disk space on Drive C and installs packages to your current drive.
Verify installation:
```
hts
check
```

🚀 Usage

Starting HelperTools

Simply type hts or helpertools in any terminal:

hts

You'll see:

================================================================================
                            HelperTools v1.0
================================================================================

HelperTools Activated ✓

HelperTools>

Basic Commands

# Get help
help

# Check version
version

# System check
check

# Create a file
create myfile.txt

# View logs
logs

# Open configuration
config

# Clear screen
clear

AI Commands

# Launch HelperToolsAI (Desktop)
brahma

# Launch HelperToolsAI (Web)
brahma web

# Configure API keys (BYOK)
apikey list                    # View all configured keys
apikey set openai sk-xxx       # Set OpenAI key
apikey set deepseek sk-xxx     # Set DeepSeek key
apikey set omniroute YOUR_KEY  # Set your OmniRoute key
apikey active omniroute        # Use OmniRoute as active provider
apikey test deepseek           # Test if the key works

API Key Management (BYOK - Bring Your Own Key)

HelperTools uses a BYOK system — you provide your own API keys for the AI providers you want to use. Your keys are stored locally in config/apikeys.json and are never sent anywhere.

Supported Providers:

openai — OpenAI (GPT-4, GPT-3.5)
deepseek — DeepSeek (deepseek-chat, deepseek-coder)
omniroute — OmniRoute (your personal proxy/router)
anthropic — Anthropic (Claude)
gemini — Google Gemini
groq — Groq (fast inference)
openrouter — OpenRouter (multi-model)
custom — Any OpenAI-compatible endpoint

Example — Using OmniRoute:

hts
apikey set omniroute your-omni-api-key
apikey active omniroute
brahma

Server Commands

# Start web server
server web

# Start application server
server app

# Check server status
server status

# Stop servers
server stop

Exiting HelperTools

exit
# or
quit

🎨 Control Interfaces

Desktop Control (Python GUI)

Launch the desktop application server for a graphical interface:

server app

Features:

Dark theme interface
Real-time command execution
Brahma AI control
Server management
Log viewer
System monitoring

Web Control (Node.js)

Launch the web server for browser-based control:

server web

Then open: http://localhost:3000

Features:

Responsive web interface
Real-time command execution
Quick command buttons
Mobile-friendly design
WebSocket support
Cross-platform access

🤖 HelperToolsAI (Brahma AI Integration)

HelperToolsAI is an advanced AI assistant that runs in the background with optimized RAM usage.

Features

Voice and text interaction
Screen analysis and OCR
File processing (images, PDFs, documents, code, audio, video)
Web automation and browsing
Code generation and debugging
Smart home control
Meeting assistance
Game updates (Steam, Epic)
And 30+ other tools

Web Mode

HelperToolsAI can run in web mode, allowing you to chat with the AI from:

Your desktop browser
Your mobile phone (connect to localhost)
Any device on your network

To use web mode:

brahma web

Then open the displayed URL in your browser or scan the QR code with your phone.

📁 Project Structure

HelperTools/
├── main.bat                    # Main controller
├── hts.bat                     # Shortcut alias
├── README.md                   # This file
├── commands/                   # Command scripts
│   ├── help.bat
│   ├── version.bat
│   ├── create.bat
│   ├── brahma.bat
│   ├── server.bat
│   ├── install.bat
│   ├── check.bat
│   ├── logs.bat
│   └── config.bat
├── config/                     # Configuration
│   ├── settings.json
│   ├── skills/                 # Command skills
│   ├── logs/                   # System logs
│   └── saved/                  # LocalStorage data
├── server/                     # Server implementations
│   ├── web_server/            # Node.js web server
│   │   ├── server.js
│   │   ├── package.json
│   │   ├── config/
│   │   ├── logs/
│   │   └── public/
│   │       └── index.html
│   └── apps_server/           # Python GUI server
│       ├── server.py
│       ├── config/
│       └── logs/
└── Brahma-AI/                 # AI integration
    ├── main.py
    ├── core/
    │   └── prompt.txt         # Updated AI prompt
    ├── actions/
    ├── agent/
    └── ...

⚙️ Configuration

Edit configuration by running:

config

Or manually edit: config/settings.json

Configuration Options

{
  "version": "1.0.0",
  "language": "en",
  "theme": "dark",
  "auto_update": true,
  "brahma_ai": {
    "mode": "desktop",
    "auto_start": false,
    "voice_enabled": true
  },
  "server": {
    "web_port": 3000,
    "app_port": 5000,
    "auto_start": false
  },
  "paths": {
    "python_packages": "F:\\HelperTools_Packages\\python",
    "node_modules": "F:\\HelperTools_Packages\\node_modules"
  }
}

🔧 Development

Adding Custom Commands

Create a new .bat file in the commands/ directory
Name it after your command (e.g., mycommand.bat)
Add your script logic
Use it by typing the command name in HelperTools

Example:

@echo off
echo Hello from my custom command!

Save as commands/mycommand.bat, then use:

hts
mycommand

Extending HelperToolsAI

Modify the AI prompt at: Brahma-AI/core/prompt.txt

Add custom actions in: Brahma-AI/actions/

🐛 Troubleshooting

Common Issues

Q: Command not found
A: Make sure HelperTools directory is added to your PATH environment variable.

Q: Python not found
A: Install Python 3.8+ from python.org and ensure it's in PATH.

Q: Node.js features not working
A: Install Node.js from nodejs.org. This is optional but required for web server features.

Q: Drive C is full
A: HelperTools automatically installs dependencies on your current drive. Run install from a drive with sufficient space.

Q: Brahma AI not responding
A: Ensure all Python dependencies are installed. Run install command and check logs.

Q: Web server won't start
A: Check if port 3000 is available. You can change the port in config/settings.json.

View Logs

logs

🤝 Contributing

Contributions are welcome! Please feel free to submit pull requests or open issues.

Areas for Contribution

Additional commands
Linux/macOS support
Mobile app development
Plugin system
Documentation improvements
Bug fixes

📄 License

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

🙏 Acknowledgments

Brahma AI - Original AI framework that powers HelperToolsAI
All contributors and testers

📞 Support

For issues, questions, or suggestions:

Open an issue on GitHub
Check the documentation
Run help command for quick reference

🗺️ Roadmap

Version 1.1 (Coming Soon)

Plugin system
Multi-language support
Enhanced web interface
Mobile companion app

Version 1.2

Linux support
macOS support
Cloud synchronization
Team collaboration features

Version 2.0

AI model customization
Advanced automation workflows
API for third-party integrations
Enterprise features

Made with ❤️ for developers who value efficiency

HelperTools - Making development easier, one command at a time.

Name		Name	Last commit message	Last commit date
Latest commit History 5 Commits
Brahma-AI		Brahma-AI
commands		commands
config		config
server		server
.gitignore		.gitignore
AUTO_UPDATE_GUIDE.md		AUTO_UPDATE_GUIDE.md
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
FAQ.md		FAQ.md
LICENSE		LICENSE
QUICKSTART.md		QUICKSTART.md
README.md		README.md
hts.bat		hts.bat
main.bat		main.bat
setup.bat		setup.bat

Folders and files

Latest commit

History

Repository files navigation

🛠️ HelperTools

📖 Overview

What is HelperTools?

✨ Features

Core Features

AI Features (HelperToolsAI)

Coming Soon

📦 Installation

Prerequisites

Quick Install

🚀 Usage

Starting HelperTools

Basic Commands

AI Commands

API Key Management (BYOK - Bring Your Own Key)

Server Commands

Exiting HelperTools

🎨 Control Interfaces

Desktop Control (Python GUI)

Web Control (Node.js)

🤖 HelperToolsAI (Brahma AI Integration)

Features

Web Mode

📁 Project Structure

⚙️ Configuration

Configuration Options

🔧 Development

Adding Custom Commands

Extending HelperToolsAI

🐛 Troubleshooting

Common Issues

View Logs

🤝 Contributing

Areas for Contribution

📄 License

🙏 Acknowledgments

📞 Support

🗺️ Roadmap

Version 1.1 (Coming Soon)

Version 1.2

Version 2.0

About

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages