⚡ Quick Install & Launch (30 Seconds)

Open Terminal (macOS / Linux) or Command Prompt / PowerShell (Windows) and run:

# 1. Install from PyPI (or from the standalone .whl file)
pip install aegis-ai-suite

# 2. Launch Core CRM + Backend + Local Companion Agent + Companion Chat
aegis-ai
# (or `aegis-crm`)

Or launch the dedicated Standalone Companion Chat directly:

aegis-chat

🧭 Included Applications & Default Ports

A single pip install aegis-ai-suite bundles the entire pre-compiled frontend and backend suite:

🛠️ CLI Reference (aegis-ai / aegis-workspace)

# Start Core CRM (default) and open http://localhost:8020
aegis-ai

# Start Standalone Companion Chat and open http://localhost:5185
aegis-chat

# Open BOTH Core CRM and Standalone Companion Chat in browser tabs
aegis-ai --both

# Run in headless server mode (do not auto-open browser)
aegis-ai --no-browser

# Customize ports on the fly
aegis-ai --port 8020 --chat-port 5185 --agent-port 47771

# Self-update from PyPI or a direct .whl URL / file
aegis-ai --update aegis-ai-suite

✨ Key Capabilities Inside aegis-ai-suite

1. 13 Operational AI Agent Squads — Specialized multi-agent pipelines for Requirement Analysis, Architecture, Coding, Code Review, QA Testing, Security Auditing, and Release Governance.
2. Aegis Pinky & Aegis Brain (2×2 Execution Matrix) — Switch seamlessly between rapid ticket fixes and deep multi-file architectural reasoning across OpenAI, Anthropic Claude, Google Gemini, Groq, and 100% local Ollama / LM Studio models.
3. Isolated Git Worktree Sandboxes — Every agent run executes in an isolated Git worktree with live unified diff inspection, dirty-worktree conflict resolution, and one-click Apply / Rollback.
4. Enterprise Knowledge Base & Code Graph RAG — Hybrid vector + AST symbol graph retrieval across repositories, PDFs, Word/Excel/PowerPoint specs, and OpenAPI schemas.
5. Offline Voice Assistant (Whisper + Phonon TTS) — Local speech-to-text and neural text-to-speech with zero cloud audio streaming required.

⚙️ Optional Workspace Configuration (settings.json)

Create a settings.json in your current working directory or ~/.nilswa-workspace-crm/settings.json to persist custom ports:

{
  "APP_MODE": "crm",
  "VERSION": "1.0.0",
  "BACKEND_PORT": 8020,
  "CHAT_PORT": 5185,
  "AGENT_PORT": 47771
}

📄 License & Author

• Author: Sachin Bose Pulikkathara (sachin.bose.p@gmail.com)
• GitHub: https://github.com/sachin-bose-p
• License: Open Commercial & Internal Use (see root LICENSE).