Skip to content

dustland/openviber

Repository files navigation

Viber Logo

OpenViber

The Open Source Cowork Desktop for Your AI Workforce

Download GitHub Stars npm version License

English · 简体中文 · Documentation · Feedback


Viber is an open-source Cowork Desktop that runs a team of AI agents on your machine. Unlike cloud-based agent frameworks, Viber runs locally with full privacy, connects outbound to your enterprise channels, and automates real work while you sleep.

⭐ 100% Open Source · 🥇 Local Deployment · 🏆 MCP Integration

  • Zero Setup — No servers to host, just npx openviber start
  • Multi-Agent Workforce — Specialized agents working in parallel
  • Human-in-the-Loop — Enterprise messaging channels (DingTalk, WeCom)
  • Privacy First — 100% local execution, data never leaves your machine

🚀 Quick Start

npx openviber start

✨ Features

🤖 Multi-Agent Workforce

Deploy specialized agents that work in parallel via simple YAML configuration:

# examples/jobs/morning-standup.yaml
name: morning-standup
schedule: "0 9 * * 1-5"
prompt: "Check my GitHub notifications and Slack mentions, summarize what needs my attention"
model: anthropic/claude-sonnet-4-20250514

🔧 Zero Configuration Skills

Capabilities defined in SKILL.md files — no code required:

---
name: git-commit
description: Stage and commit changes
---

git add . && git commit -m "$message"

🌐 MCP Integration

Connect to any Model Context Protocol server for extended capabilities:

mcp_servers:
  - name: github
    command: npx -y @modelcontextprotocol/server-github

👤 Human-in-the-Loop

Critical for long-running vibe-working tasks like vibe-coding:

  • Approval Gates — Pause for human review before critical actions
  • Interactive Channels — Real-time collaboration via DingTalk/WeCom
  • Progressive Autonomy — Start supervised, gradually increase agent freedom
  • Context Handoff — Seamlessly transfer context between human and agent
# Example: Require approval for deployments
approval_required:
  - deploy
  - delete
  - billing

💬 Enterprise Channels

Native integrations for DingTalk (钉钉) and WeCom (企业微信):

openviber start --channel dingtalk --token YOUR_TOKEN
openviber start --channel wecom --corpid YOUR_CORP

📚 Examples

🩹 Antigravity — Self-Healing for AI Coding Tools

A built-in skill example that monitors and recovers AI coding tools:

# examples/jobs/antigravity-healer.yaml
name: antigravity-healer
schedule: "*/3 * * * * *" # every 3 seconds
skill: antigravity
prompt: "Check Antigravity IDE status and auto-recover if errors found"
  • Monitors all IDE windows for agent crashes
  • Auto-recovers by clicking Retry across multiple windows
  • Keeps your flow uninterrupted

🏗️ Architecture

┌─────────────────────────────────────────────────┐
│              Viber Cowork Desktop               │
│                                                 │
│  ┌──────────┐  ┌────────┐  ┌────────────────┐   │
│  │ViberAgent│──│ Agents │──│     Tools      │   │
│  │ (Leader) │  │(Workers)│  │(Browser/File)  │   │
│  └──────────┘  └────────┘  └────────────────┘   │
│        │                                        │
│   ┌────┴─────────────────────┐                  │
│   │         Scheduler        │                  │
│   │    (YAML Cron Jobs)      │                  │
│   └──────────────────────────┘                  │
│        │                                        │
│   ┌────┴─────────────────────┐                  │
│   │        Channels          │                  │
│   │  DingTalk | WeCom | Web  │                  │
│   └──────────────────────────┘                  │
└─────────────────────────────────────────────────┘
          ↓                    ↓
    Outbound Only      Local Execution

📦 Three Pillars

Component What Where
Jobs Scheduled tasks (YAML cron) examples/jobs/
Skills Capabilities (SKILL.md) skills/
Tools Low-level primitives src/tools/

📊 Comparison

Viber Cloud Agents IDE Plugins
Deployment Local app Cloud server Editor only
Connection Outbound Inbound None
Jobs YAML cron Complex code Manual
Privacy 100% local Data leaves Varies
Channels DingTalk/WeCom WhatsApp/Telegram None

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

📄 License

This project is licensed under the Apache License 2.0.

Copyright 2024-2026 Dustland

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

🙏 Acknowledgments

Viber is built on the shoulders of amazing open-source projects:


Website · Documentation · Issues

Made with ❤️ by Dustland

If you find Viber helpful, please ⭐ star us on GitHub!

About

Agent Framework for Vibe-Working.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •