shepaw  by shepaw

Empowering local-first AI agent cooperation

Created 2 months ago
258 stars

Top 98.0% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

ShePaw is a cross-platform, local-first AI assistant hub for private, collaborative interaction with multiple AI agents. It offers a rich chat experience, advanced automation, and robust agent management, empowering users to securely navigate AI on their own devices.

How It Works

The core architecture emphasizes a local-first philosophy, storing all user data on-device via SQLite and Hive. ShePaw facilitates real-time, bidirectional communication through its Agent Communication Protocol (ACP), built on JSON-RPC 2.0 over WebSockets. It integrates with over nine major cloud and local LLMs, supporting multimodal inputs and interactive chat components. Collaboration is key, featuring direct messaging and group channels with three orchestration modes: Standard (round-robin), Planning (user-approved tasks), and Flow (automated multi-stage workflows).

Quick Start & Requirements

Clone the repository, run flutter pub get, and execute flutter run. Prerequisites include Flutter 3.x, Dart SDK 3.0+, and Xcode (iOS/macOS) or Android Studio (Android). Detailed build instructions are in BUILD_GUIDE.md.

Highlighted Details

  • Agent Communication Protocol (ACP): Real-time, bidirectional WebSocket communication with AI agents, integrating numerous LLMs (OpenAI, Claude, Gemini, Ollama, etc.).
  • Advanced Collaboration Modes: Standard, Planning (user-approved tasks), and Flow (automated multi-stage workflows) for group agent interactions.
  • Rich Multimodal Experience: Supports text, images, audio, video, Markdown, code highlighting, and interactive UI components.
  • Privacy-Focused: All data stored locally, with password/biometric locks, encrypted API keys, and inference log audit.

Maintenance & Community

The provided documentation does not detail specific contributors, sponsorships, or community channels (e.g., Discord, Slack).

Licensing & Compatibility

Released under the MIT License, which is highly permissive for commercial use and integration into closed-source projects.

Limitations & Caveats

As a Flutter-based application, ShePaw relies on the framework for cross-platform capabilities. Specific performance nuances or deep OS integrations may be abstracted. No explicit mention of alpha/beta status, known bugs, or deprecations is present.

Health Check
Last Commit

3 days ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
0 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.