Sign inSign up

okjodom/aiders

By okjodom

•Updated 7 months ago

Image
0

2.5K

okjodom/aiders repository overview

⁠AIDERS

A multi-tenant platform for deploying and managing OpenClaw⁠ AI agents on DigitalOcean, built with Next.js and Stack Auth⁠. AIDERS enables teams to provision, monitor, and control OpenClaw instances from a unified dashboard.

⁠Features

⁠OpenClaw Agent Management
  • One-Click Deployment: Provision OpenClaw agents on DigitalOcean droplets with cloud-init automation
  • Lifecycle Controls: Start, stop, reboot, and destroy agents from the dashboard
  • Real-Time Monitoring: Track agent status, view action history, and inspect configuration
  • LLM Provider Support: Deploy agents with Anthropic (Claude) or OpenAI (GPT) — bring your own API key
⁠Multi-Tenancy
  • Team Management: Create and manage multiple teams powered by Stack Auth⁠
  • Role-Based Permissions: Team admins configure DigitalOcean credentials, all members can deploy and manage agents
  • Team Isolation: Each team's credentials, agents, and configuration are completely isolated
⁠Tech Stack
  • Next.js 16 with App Router
  • TypeScript with strict mode
  • Tailwind CSS & Shadcn UI components
  • Stack Auth⁠ for authentication and team management
  • DigitalOcean API⁠ for droplet provisioning
  • OpenClaw⁠ as the deployed AI agent framework
  • Dark mode support

⁠Getting Started

  1. Clone the repository

    git clone https://github.com/okjodom/aiders.git
    cd aiders
    
  2. Install dependencies

    npm install
    
  3. Register an account on Stack Auth⁠, copy the keys from the dashboard, and paste them into .env.local. Then enable "client team creation" on the team settings tab.

    cp .env.local.example .env.local
    

    Required variables:

    • NEXT_PUBLIC_STACK_PROJECT_ID
    • NEXT_PUBLIC_STACK_PUBLISHABLE_CLIENT_KEY
    • STACK_SECRET_SERVER_KEY
  4. Start the development server and go to http://localhost:3030⁠

    npm run dev
    
⁠With Docker
npm run dcu

⁠Usage

  1. Create a team in the dashboard
  2. Configure DigitalOcean — navigate to Settings, enter your DO API token, and test the connection
  3. Deploy an agent — go to Agents, click "Create Agent", choose a name, LLM provider, API key, region, and size
  4. Manage agents — start, stop, reboot, or destroy agents from the agent detail page
  5. Monitor — view status, IP address, action history, and configuration for each agent

⁠Project Structure

app/
  (landing-page)/        # Public landing page
  dashboard/             # Protected dashboard pages
    [teamId]/
      agents/            # Agent list and detail pages
      settings/          # Team DO configuration
  api/team/[teamId]/
    agents/              # Agent CRUD and actions
    config/              # DO config, regions, sizes
components/              # UI components (agent cards, status, config)
lib/
  digitalocean/          # DO API client and cloud-init generator
  storage/               # Team metadata storage layer
  types/                 # TypeScript type definitions

⁠API Endpoints

RouteMethodsAuthPurpose
/api/team/[teamId]/configGET, POSTadminDO configuration
/api/team/[teamId]/config/testPOSTadminTest DO token
/api/team/[teamId]/config/regionsGETmemberList DO regions
/api/team/[teamId]/config/sizesGETmemberList DO sizes
/api/team/[teamId]/agentsGET, POSTmemberList / create agents
/api/team/[teamId]/agents/[agentId]GET, DELETEmemberAgent detail / destroy
/api/team/[teamId]/agents/[agentId]/actionsPOSTmemberpower_on, power_off, reboot
/api/team/[teamId]/agents/[agentId]/logsGETmemberDroplet action history
  • OpenClaw⁠ — Open-source AI assistant gateway for messaging platforms
  • Stack Auth⁠ — Open-source authentication and team management
  • Shadcn UI⁠ — Re-usable component library
  • Next.js⁠ — React framework for production

⁠License

MIT

Tag summary

Content type

Image

Digest

sha256:1e4be5022…

Size

77.2 MB

Last updated

7 months ago

docker pull okjodom/aiders