OpenDuet

Overview

OpenDuet is a template for a proactive AI agent built on OpenBot and CopilotKit. It starts with a morning brief, keeps working in its own browser, workspace, and shell while the user is away, and pauses for approval before sending, paying, signing, or deleting anything. It is designed to be copied and customized, with its name, Bots, channels, model, and skills kept in one folder.

Key Features

• A morning brief summarizes what needs attention, what can wait, and today's calendar.
• Each agent runs on its own computer with Chromium, a workspace, a browser profile, and a shell.
• Approval gates pause actions that send, pay, sign, or delete, with Allow once, Always allow, and Refuse.
• Passwords are entered through a masked box, and saved credentials are encrypted and write-only.
• Gmail and Google Calendar can be connected per person for mail reading and calendar-aware briefs.
• Skills and scheduled routines let users reuse instructions and run tasks on a schedule.

Use Cases

• Starting the day with a short brief that separates what needs a decision from what can wait.
• Delegating a longer task that continues in its own browser and workspace while the user is away.
• Connecting Gmail and Google Calendar so the agent can read mail and today's calendar.
• Running scheduled routines that execute work as the user.

Getting Started

• Install Docker, Bun 1.3 or newer, Node for npx, and have a model key plus a CopilotKit Intelligence project.
• Clone the repository, copy .env.example to .env, and run bun install.
• Sign in with the CopilotKit CLI, select an Intelligence project, and run bun openbot/scripts/setup-learning.ts.
• Set OPENAI_API_KEY or configure another supported provider and model in .env.
• Run bash scripts/start.sh and open the local app on port 3010.

Deployment & Requirements

• Docker, Bun 1.3 or newer, Node for npx, a model key, and a CopilotKit Intelligence project are required.
• The server will not start without the CopilotKit Intelligence key; the free Developer plan is enough.
• Gmail and Google Calendar require a Google OAuth client registered once by an administrator.
• Voice input requires a speech-to-text provider on the server.
• PostgreSQL plus pgvector stores policy, approvals, audit records, and encrypted credentials.

Before You Adopt

• License: MIT. Review its terms before using, modifying, or distributing the project.
• The project labels itself as early and in active development, so users should expect change.
• CopilotKit Intelligence is an external requirement for threads and memory, and the server cannot start without its key.
• There is no published hosted or deployment guide and no OpenDuet image yet, so Quick start is the supported route.
• The runtime sends usage telemetry to CopilotKit unless it is disabled.
• Gmail and Calendar integration depends on an administrator-registered Google OAuth client.