β Multi-Provider Support - (OpenAI/DeepSeek)
β File Analysis - Reference files with @file.txt for context-aware responses
β Session Persistence - Save/load conversations with !save and !load
β Rich Markdown Rendering
β¨ Interactive CLI - Natural language queries or commands
π File Integration - Supports .py, .json, .txt, and 10+ file types
β± Real-Time Processing - Loading spinners and timeout handling
π Test open ports | πΆ Network connectivity check
π½ Disk usage summary | π Find running processes
π‘ Audit sudo users | π SSH config analyzer
# Clone the repository
git clone https://github.com/alaadotcom/CarthageAI.git
cd CarthageAI
# Install dependencies
pip install -r requirements.txt
π₯οΈ Usage
Basic Commands:
ββββββββββββββββ¬ββββββββββββββββββββββββββββββββββββββββββ
β Command β Description β
ββββββββββββββββΌββββββββββββββββββββββββββββββββββββββββββ€
β !help β Show help menu β
β !model β Switch AI models β
β @file.txt β Analyze file content β
β !save β Save current conversation β
β !load <id> β Load previous session β
ββββββββββββββββ΄ββββββββββββββββββββββββββββββββββββββββββ
Examples:
# Direct query
python carthage_ai.py "Explain Python decorators"
# File analysis
python carthage_ai.py "Fix this code" @broken_script.py
# Interactive mode:
python carthage_ai.py
> @config.json What's wrong with this configuration?
π οΈ Sysadmin Tools
_________________________________________
/ Port Check | Disk Space | Process Find \
| SSH Audit | Ping Test | Sudo Check |
\________________________________________/
Example:
!portcheck example.com 80
!diskspace
!findproc nginx
API keys stored locally in config.json