⚡ ZuesHammer - Thor's Hammer

🔨 The Power of Gods · One Strike · Your Digital World Master

⚡ One-Line Introduction

ZuesHammer Thor's Hammer — With the power of thunder, command the digital world.

Fusing the best of three open-source AI agents, powered by ultra-efficient AI engine, making AI your digital world avatar.

🔥 Why ZuesHammer?

💪 Your AI, Zero Fluff

┌──────────────────────────────────────────────────────────────┐
│                                                              │
│    ⚡ Other AI:   "Let me think about it..." "Based on..."  │
│                                                              │
│    ⚡ ZuesHammer: "Got it, executing." "Done."             │
│                                                              │
└──────────────────────────────────────────────────────────────┘

🚀 Efficiency Revolution - ChinaWhAPI

┌────────────────────────────────────────────────────────────┐
│                                                            │
│    🔋 Traditional AI:     Burning cash like oil           │
│                            Monthly bills are scary          │
│                                                            │
│    ⚡ ZuesHammer:          ChinaWhAPI - 80% more efficient │
│                            Same results, lower cost        │
│                            👉 chinawhapi.com               │
│                                                            │
└────────────────────────────────────────────────────────────┘

ChinaWhAPI Advantages:

💰 Cost Efficiency: 50%-80% cheaper than official APIs
⚡ Lightning Fast: Direct connection, latency under 100ms
🔋 Smart Computing: Intelligent scheduling, pay for what you use
🌏 Global Access: Works everywhere, stable as a rock

⚡ Core Capabilities

🗣️ Voice-First - Speak and Go

        🎤 "Hey Zues, find me flights to Shanghai tomorrow"
                    ↓
              ⚡ Got it!
                    ↓
        🛫 Found: Tomorrow Shanghai→Beijing ¥380
                    ↓
        💬 "Want me to book it?"

🧠 Local Brain - Gets Smarter Over Time

Your Actions → Pattern Recognition → Skill Generation → Continuous Evolution
    ↓             ↓                   ↓                ↓
 Observe      Find Patterns       Auto-learn        Know You Better

🔐 Three Permission Modes - Security in Your Hands

Mode	Icon	Permission	Best For
Semi-Open	🛡️	High-risk needs confirmation	Daily use
Full Unleash	🔓	No restrictions	Power users ⚠️
Locked	🔒	Low-risk only	Testing

🌐 Multi-Device Control - Anywhere, Anytime

Phone 📱 ─── Scan to Auth ───→ Desktop 💻
  │                              │
  │ ←── Push Confirm ──────── │
  │                              │
  └──── Remote Control ◄────────┘

🎯 Four Work Modes

⚡ Work Mode ──── Full power, execute tasks fast
💭 Think Mode ──── Auto reflection when idle
📚 Learn Mode ──── Learn from you, adapt to you
🚀 Evolve Mode ─── Long-term optimization, self-improvement

🛠️ Use Cases

🌅 Daily All-in-One Assistant

"Check tomorrow's weather in Beijing"
"Remind me of the 3pm meeting"
"Reply to this email for me"
"Book a restaurant for this weekend"

💼 Office Automation

"Summarize today's work report"
"Fill out this form for me"
"Generate this month's sales report"
"Analyze competitor data"

⚡ Speed & Passion

"Grab tomorrow's 10am concert tickets"  ← Speed demon
"Monitor this product, notify me when in stock"
"Auto-fill order information"

🎨 Creative Production

"Write promotional copy for this product"
"Design a logo sketch"
"Optimize this code"
"Write a poem about summer"

📦 Quick Install

# One-liner install
curl -fsSL https://raw.githubusercontent.com/pengrambo3-tech/zueshammer/main/install.sh | bash

# Or clone
git clone https://github.com/pengrambo3-tech/zueshammer.git
cd zueshammer
./install.sh

Prerequisites

Python 3.10+
Recommended: Get ChinaWhAPI Key - 80% more efficient

🚀 Quick Start

# Launch ZuesHammer
python3 zueshammer/zueshammer.py

# Semi-open mode (default)
python3 zueshammer/zueshammer.py --mode semi_open

# Full Unleash mode ⚠️
python3 zueshammer/zueshammer.py --mode full_unleashed

# Voice-first mode
python3 zueshammer/zueshammer.py --voice-first

🔧 Configure API

# ChinaWhAPI (Recommended - Efficient & Cost-saving)
export CHINA_WHAPI_KEY="your-key-from-chinawhapi.com"

# Or OpenAI
export OPENAI_API_KEY="sk-..."

# Or Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."

🏗️ Architecture

╔══════════════════════════════════════════════════════════════╗
║                     ⚡ ZuesHammer ⚡                        ║
║                       Thor's Hammer                         ║
╠══════════════════════════════════════════════════════════════╣
║                                                              ║
║  🎙️ Voice Layer ── Wake Detection / ASR / TTS             ║
║                                                              ║
║  🧠 Brain Layer ── Thinking Engine / Memory / Evolution      ║
║                                                              ║
║  ⚙️ Execute Layer ── Browser / Terminal / File / Network   ║
║                                                              ║
║  🔐 Security Layer ── Permission / Audit / Screenshot       ║
║                                                              ║
║  📱 Access Layer ── Web UI / CLI / Mobile                  ║
║                                                              ║
╚══════════════════════════════════════════════════════════════╝

📁 Project Structure

zueshammer/
├── ⚡ zueshammer/          # Main entry point
├── 🧠 brain/               # Local brain (thinking+memory+learning)
├── 🗣️ voice/               # Voice system (TTS output)
├── 🔐 security/            # Permission system (modes)
├── ⚙️ tools/              # Tool system (30+ tools)
├── 📱 ui/                  # Control interface
├── 🔑 auth/                # Multi-device auth
├── 📋 confirm/             # Screenshot confirmation
├── ⚡ modes/               # Four work modes
├── 🤖 llm/                 # LLM integration (ChinaWhAPI/OpenAI/Claude)
└── 🛠️ hermes_*/          # Hermes core components

🛡️ Security Statement

⚠️⚠️⚠️ Full Unleash Mode Warning ⚠️⚠️⚠️

This is TRUE beast mode!

• No sandbox protection
• Can execute any operation
• No confirmation needed

⚖️ By using Full Unleash you agree to:
• Take responsibility for all actions
• No illegal activities
• Adult decision-making

🌐 Website

Check out our beautiful landing page: ⚡ ZuesHammer Website

Features:

🎨 Modern gradient design
📱 Fully responsive
⚡ Lightning fast
🌙 Dark theme
🎯 Smooth animations

🙏 Acknowledgments

Based on these excellent open-source projects:

Hermes Agent - Memory system and skill engine
ClaudeCode - Tool calling architecture
OpenClaw - Browser automation and multi-model routing

⚡ ZuesHammer - With the Power of Thunder, Command Everything 🧨