mageagent-local 2.0.1

package/menubar-app/MageAgentMenuBar/Info.plist

@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>CFBundleDevelopmentRegion</key>
+    <string>en</string>
+    <key>CFBundleExecutable</key>
+    <string>MageAgentMenuBar</string>
+    <key>CFBundleIconFile</key>
+    <string>AppIcon</string>
+    <key>CFBundleIconName</key>
+    <string>AppIcon</string>
+    <key>CFBundleIdentifier</key>
+    <string>ai.adverant.mageagent.menubar</string>
+    <key>CFBundleInfoDictionaryVersion</key>
+    <string>6.0</string>
+    <key>CFBundleName</key>
+    <string>MageAgent</string>
+    <key>CFBundleDisplayName</key>
+    <string>MageAgent</string>
+    <key>CFBundlePackageType</key>
+    <string>APPL</string>
+    <key>CFBundleShortVersionString</key>
+    <string>2.0.0</string>
+    <key>CFBundleVersion</key>
+    <string>1</string>
+    <key>LSApplicationCategoryType</key>
+    <string>public.app-category.developer-tools</string>
+    <key>LSMinimumSystemVersion</key>
+    <string>13.0</string>
+    <key>LSUIElement</key>
+    <true/>
+    <key>NSHumanReadableCopyright</key>
+    <string>Copyright © 2025 Adverant. All rights reserved.</string>
+    <key>NSPrincipalClass</key>
+    <string>NSApplication</string>
+</dict>
+</plist>

package/menubar-app/MageAgentMenuBar/main.swift

@@ -0,0 +1,16 @@
+import Cocoa
+
+// MARK: - Application Entry Point
+// Using NSApplicationMain pattern for proper object lifecycle management
+// The AppDelegate is stored as a strong reference to prevent deallocation
+
+// Strong reference to prevent ARC from deallocating the delegate
+// This is CRITICAL - NSApplication.delegate is a WEAK reference
+private var appDelegateReference: AppDelegate!
+
+autoreleasepool {
+    let app = NSApplication.shared
+    appDelegateReference = AppDelegate()
+    app.delegate = appDelegateReference
+    app.run()
+}

package/menubar-app/Package.swift

@@ -0,0 +1,18 @@
+// swift-tools-version:5.9
+import PackageDescription
+
+let package = Package(
+    name: "MageAgentMenuBar",
+    platforms: [
+        .macOS(.v13)
+    ],
+    targets: [
+        .executableTarget(
+            name: "MageAgentMenuBar",
+            path: "MageAgentMenuBar",
+            resources: [
+                .process("Info.plist")
+            ]
+        )
+    ]
+)

package/menubar-app/build/MageAgentMenuBar.app/Contents/Info.plist

@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>CFBundleDevelopmentRegion</key>
+    <string>en</string>
+    <key>CFBundleExecutable</key>
+    <string>MageAgentMenuBar</string>
+    <key>CFBundleIconFile</key>
+    <string>AppIcon</string>
+    <key>CFBundleIconName</key>
+    <string>AppIcon</string>
+    <key>CFBundleIdentifier</key>
+    <string>ai.adverant.mageagent.menubar</string>
+    <key>CFBundleInfoDictionaryVersion</key>
+    <string>6.0</string>
+    <key>CFBundleName</key>
+    <string>MageAgent</string>
+    <key>CFBundleDisplayName</key>
+    <string>MageAgent</string>
+    <key>CFBundlePackageType</key>
+    <string>APPL</string>
+    <key>CFBundleShortVersionString</key>
+    <string>2.0.0</string>
+    <key>CFBundleVersion</key>
+    <string>1</string>
+    <key>LSApplicationCategoryType</key>
+    <string>public.app-category.developer-tools</string>
+    <key>LSMinimumSystemVersion</key>
+    <string>13.0</string>
+    <key>LSUIElement</key>
+    <true/>
+    <key>NSHumanReadableCopyright</key>
+    <string>Copyright © 2025 Adverant. All rights reserved.</string>
+    <key>NSPrincipalClass</key>
+    <string>NSApplication</string>
+</dict>
+</plist>

package/menubar-app/build/MageAgentMenuBar.app/Contents/PkgInfo

@@ -0,0 +1 @@
+APPLMage

package/menubar-app/build.sh

@@ -0,0 +1,96 @@
+#!/bin/bash
+# Build MageAgent Menu Bar App
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+APP_NAME="MageAgentMenuBar"
+BUILD_DIR="$SCRIPT_DIR/build"
+APP_DIR="$BUILD_DIR/$APP_NAME.app"
+CONTENTS_DIR="$APP_DIR/Contents"
+MACOS_DIR="$CONTENTS_DIR/MacOS"
+RESOURCES_DIR="$CONTENTS_DIR/Resources"
+
+echo "Building MageAgent Menu Bar App..."
+
+# Clean previous build
+rm -rf "$BUILD_DIR"
+mkdir -p "$MACOS_DIR" "$RESOURCES_DIR"
+
+# Compile Swift files
+echo "Compiling Swift..."
+swiftc -o "$MACOS_DIR/$APP_NAME" \
+    -framework Cocoa \
+    -framework UserNotifications \
+    -target arm64-apple-macos13.0 \
+    -O \
+    "$SCRIPT_DIR/MageAgentMenuBar/main.swift" \
+    "$SCRIPT_DIR/MageAgentMenuBar/AppDelegate.swift"
+
+# Copy Info.plist
+echo "Copying Info.plist..."
+cp "$SCRIPT_DIR/MageAgentMenuBar/Info.plist" "$CONTENTS_DIR/Info.plist"
+
+# Create white app icon with transparent background
+echo "Creating white app icon..."
+ICONSET_DIR="$BUILD_DIR/AppIcon.iconset"
+mkdir -p "$ICONSET_DIR"
+
+# Use Python to create white icons from the transparent source
+python3 << 'PYTHON_EOF'
+from PIL import Image
+import os
+
+source = "/Users/don/Adverant/Adverant.ai/public/brand/adverant-icon-github-final.png"
+output_dir = os.path.expanduser("~/.claude/MageAgentMenuBar/build/AppIcon.iconset")
+
+img = Image.open(source).convert("RGBA")
+pixels = img.load()
+width, height = img.size
+
+# Convert to white (preserve alpha)
+for y in range(height):
+    for x in range(width):
+        r, g, b, a = pixels[x, y]
+        if a > 0:
+            pixels[x, y] = (255, 255, 255, a)
+
+sizes = [
+    (16, "icon_16x16.png"), (32, "icon_16x16@2x.png"),
+    (32, "icon_32x32.png"), (64, "icon_32x32@2x.png"),
+    (128, "icon_128x128.png"), (256, "icon_128x128@2x.png"),
+    (256, "icon_256x256.png"), (512, "icon_256x256@2x.png"),
+    (512, "icon_512x512.png"), (1024, "icon_512x512@2x.png"),
+]
+
+for size, filename in sizes:
+    resized = img.resize((size, size), Image.LANCZOS)
+    resized.save(os.path.join(output_dir, filename), "PNG")
+PYTHON_EOF
+
+# Convert to icns
+iconutil -c icns "$ICONSET_DIR" -o "$RESOURCES_DIR/AppIcon.icns" 2>/dev/null || echo "Note: iconutil not available"
+
+# Copy menu bar icon
+cp "$HOME/.claude/mageagent-menubar/icons/icon_18x18@2x.png" "$RESOURCES_DIR/icon.png" 2>/dev/null || true
+
+# Create PkgInfo
+echo "APPLMage" > "$CONTENTS_DIR/PkgInfo"
+
+echo ""
+echo "Build complete!"
+echo "App location: $APP_DIR"
+echo ""
+
+# Install to Applications
+INSTALL_DIR="/Applications"
+if [ -d "$INSTALL_DIR" ]; then
+    echo "Installing to /Applications..."
+    rm -rf "$INSTALL_DIR/$APP_NAME.app"
+    cp -R "$APP_DIR" "$INSTALL_DIR/"
+    echo "Installed to $INSTALL_DIR/$APP_NAME.app"
+fi
+
+echo ""
+echo "To run: open /Applications/$APP_NAME.app"
+echo "To add to Login Items: System Settings > General > Login Items > + > $APP_NAME"

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "mageagent-local",
+  "version": "2.0.1",
+  "description": "Run 4 AI models together on Apple Silicon. Get results that rival cloud AI. Pay nothing. Forever.",
+  "keywords": [
+    "ai",
+    "llm",
+    "mlx",
+    "apple-silicon",
+    "m1",
+    "m2",
+    "m3",
+    "m4",
+    "multi-model",
+    "orchestration",
+    "qwen",
+    "hermes",
+    "local-ai",
+    "private-ai",
+    "offline-ai",
+    "claude-code",
+    "menubar",
+    "macos",
+    "react-loop",
+    "tool-calling",
+    "mixture-of-agents"
+  ],
+  "homepage": "https://github.com/adverant/nexus-local-mageagent#readme",
+  "bugs": {
+    "url": "https://github.com/adverant/nexus-local-mageagent/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/adverant/nexus-local-mageagent.git"
+  },
+  "license": "MIT",
+  "author": "Adverant <info@adverant.ai>",
+  "type": "module",
+  "bin": {
+    "mageagent": "./bin/mageagent.js"
+  },
+  "files": [
+    "bin/",
+    "mageagent/",
+    "menubar-app/",
+    "scripts/",
+    "config/",
+    "docs/",
+    "README.md",
+    "QUICK_START.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "postinstall": "node bin/postinstall.js",
+    "start": "node bin/mageagent.js start",
+    "stop": "node bin/mageagent.js stop",
+    "restart": "node bin/mageagent.js restart",
+    "status": "node bin/mageagent.js status",
+    "logs": "node bin/mageagent.js logs",
+    "test": "node bin/mageagent.js test",
+    "install:all": "npm run install:deps && npm run install:models && npm run install:menubar && npm run install:launchagent",
+    "install:deps": "pip install -r requirements.txt",
+    "install:models": "node bin/mageagent.js install-models",
+    "install:menubar": "cd menubar-app && ./build.sh",
+    "install:launchagent": "node bin/install-launchagent.js",
+    "uninstall:menubar": "rm -rf /Applications/MageAgentMenuBar.app",
+    "uninstall:launchagent": "launchctl unload ~/Library/LaunchAgents/ai.adverant.mageagent.plist 2>/dev/null; launchctl unload ~/Library/LaunchAgents/ai.adverant.mageagent.menubar.plist 2>/dev/null",
+    "setup": "npm run install:all && npm run start",
+    "doctor": "node bin/mageagent.js doctor"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "arm64"
+  ],
+  "preferGlobal": true
+}

package/scripts/build-dmg.sh

@@ -0,0 +1,196 @@
+#!/bin/bash
+
+# MageAgent DMG Installer Builder
+# Creates a professional macOS DMG installer
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+BUILD_DIR="$PROJECT_ROOT/dist"
+DMG_NAME="MageAgent-2.0.0"
+VOLUME_NAME="MageAgent Installer"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+echo -e "${BLUE}========================================${NC}"
+echo -e "${BLUE}  MageAgent DMG Installer Builder${NC}"
+echo -e "${BLUE}========================================${NC}"
+echo ""
+
+# Check for required tools
+if ! command -v hdiutil &> /dev/null; then
+    echo -e "${RED}Error: hdiutil not found (requires macOS)${NC}"
+    exit 1
+fi
+
+# Create build directory
+echo -e "${YELLOW}Creating build directory...${NC}"
+rm -rf "$BUILD_DIR"
+mkdir -p "$BUILD_DIR/dmg-contents"
+
+# Build the menu bar app
+echo -e "${YELLOW}Building MageAgentMenuBar.app...${NC}"
+cd "$PROJECT_ROOT/menubar-app"
+./build.sh
+
+# Copy app to DMG contents
+echo -e "${YELLOW}Preparing DMG contents...${NC}"
+cp -R "$PROJECT_ROOT/menubar-app/build/MageAgentMenuBar.app" "$BUILD_DIR/dmg-contents/"
+
+# Create installer script that will run on first launch
+cat > "$BUILD_DIR/dmg-contents/Install MageAgent.command" << 'INSTALLER'
+#!/bin/bash
+
+# MageAgent Installer Script
+# Run this after dragging MageAgentMenuBar.app to Applications
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+echo "=========================================="
+echo "  MageAgent Installation"
+echo "=========================================="
+echo ""
+
+# Check for Apple Silicon
+if [[ $(uname -m) != "arm64" ]]; then
+    echo "Error: MageAgent requires Apple Silicon (M1/M2/M3/M4)"
+    exit 1
+fi
+
+# Create directories
+echo "Creating directories..."
+mkdir -p ~/.claude/mageagent
+mkdir -p ~/.claude/scripts
+mkdir -p ~/.claude/debug
+mkdir -p ~/.cache/mlx-models
+
+# Download server files from GitHub
+echo "Downloading server components..."
+REPO_URL="https://raw.githubusercontent.com/adverant/nexus-local-mageagent/main"
+
+curl -sL "$REPO_URL/mageagent/server.py" -o ~/.claude/mageagent/server.py
+curl -sL "$REPO_URL/scripts/mageagent-server.sh" -o ~/.claude/scripts/mageagent-server.sh
+chmod +x ~/.claude/scripts/mageagent-server.sh
+
+# Install Python dependencies
+echo "Installing Python dependencies..."
+pip3 install --quiet mlx mlx-lm fastapi uvicorn pydantic huggingface_hub 2>/dev/null
+
+# Create LaunchAgent for server
+echo "Setting up auto-start..."
+cat > ~/Library/LaunchAgents/ai.adverant.mageagent.plist << 'PLIST'
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>ai.adverant.mageagent</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>/bin/bash</string>
+        <string>-c</string>
+        <string>~/.claude/scripts/mageagent-server.sh start</string>
+    </array>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <false/>
+    <key>StandardOutPath</key>
+    <string>~/.claude/debug/mageagent.log</string>
+    <key>StandardErrorPath</key>
+    <string>~/.claude/debug/mageagent.error.log</string>
+</dict>
+</plist>
+PLIST
+
+launchctl load ~/Library/LaunchAgents/ai.adverant.mageagent.plist 2>/dev/null || true
+
+# Start the server
+echo "Starting MageAgent server..."
+~/.claude/scripts/mageagent-server.sh start
+
+# Wait for server
+sleep 3
+
+# Test
+if curl -s http://localhost:3457/health > /dev/null 2>&1; then
+    echo ""
+    echo "=========================================="
+    echo "  Installation Complete!"
+    echo "=========================================="
+    echo ""
+    echo "MageAgent is running at: http://localhost:3457"
+    echo ""
+    echo "Next steps:"
+    echo "  1. Open MageAgentMenuBar from Applications"
+    echo "  2. Click the menu bar icon to manage the server"
+    echo "  3. Download models (~110GB) via menu: Load Models > Load All"
+    echo ""
+    echo "Documentation: https://github.com/adverant/nexus-local-mageagent"
+else
+    echo ""
+    echo "Warning: Server may not have started correctly."
+    echo "Check logs: ~/.claude/debug/mageagent.log"
+fi
+
+echo ""
+echo "Press Enter to close..."
+read
+INSTALLER
+
+chmod +x "$BUILD_DIR/dmg-contents/Install MageAgent.command"
+
+# Create README
+cat > "$BUILD_DIR/dmg-contents/README.txt" << 'README'
+MageAgent - Multi-Model AI Orchestration for Apple Silicon
+==========================================================
+
+Installation Steps:
+1. Drag MageAgentMenuBar.app to your Applications folder
+2. Double-click "Install MageAgent.command" to complete setup
+3. Open MageAgentMenuBar from Applications
+
+Requirements:
+- macOS 13.0 (Ventura) or later
+- Apple Silicon (M1/M2/M3/M4)
+- 64GB+ unified memory recommended (128GB for all models)
+- Python 3.9+
+
+The installer will:
+- Download server components from GitHub
+- Install Python dependencies (MLX, FastAPI)
+- Configure auto-start on login
+- Start the MageAgent server
+
+Models (~110GB total) are downloaded on-demand via the menu bar app.
+
+For help: https://github.com/adverant/nexus-local-mageagent
+README
+
+# Create symlink to Applications
+ln -s /Applications "$BUILD_DIR/dmg-contents/Applications"
+
+# Create DMG
+echo -e "${YELLOW}Creating DMG...${NC}"
+hdiutil create -volname "$VOLUME_NAME" \
+    -srcfolder "$BUILD_DIR/dmg-contents" \
+    -ov -format UDZO \
+    "$BUILD_DIR/$DMG_NAME.dmg"
+
+# Clean up
+rm -rf "$BUILD_DIR/dmg-contents"
+
+echo ""
+echo -e "${GREEN}========================================${NC}"
+echo -e "${GREEN}  DMG Created Successfully!${NC}"
+echo -e "${GREEN}========================================${NC}"
+echo ""
+echo -e "DMG Location: ${BLUE}$BUILD_DIR/$DMG_NAME.dmg${NC}"
+echo ""
+echo "To test: open $BUILD_DIR/$DMG_NAME.dmg"