name: Construct
description: |
  Construct is a fast, small, and fully autonomous AI personal assistant
  infrastructure built in 100% Rust. Deploy anywhere, swap anything.
  Connect any LLM provider (OpenRouter, OpenAI, Anthropic, Ollama) and
  interact via a built-in web dashboard, REST API, or WebSocket gateway.
  Supports multi-channel communication (Discord, Telegram, Matrix, Slack,
  WhatsApp, Nostr, Lark), persistent memory, scheduled tasks, and
  autonomous tool use.

instructions: |
  After deployment, access the Construct gateway at the assigned domain
  on port 42617. Set your LLM provider API key in the environment
  variables. The default provider is OpenRouter — get a key at
  https://openrouter.ai/keys. You can switch to OpenAI, Anthropic,
  or a local Ollama instance by changing the PROVIDER variable.

changeLog:
  - date: 2026-04-21
    description: CalVer stream starts at v2026.4.21

links:
  - label: Website
    url: https://construct.com
  - label: Documentation
    url: https://github.com/KumihoIO/construct-os#readme
  - label: Github
    url: https://github.com/KumihoIO/construct-os

contributors:
  - name: Kumiho Inc.
    url: https://github.com/KumihoIO

logo: construct.png

schema:
  type: object
  required:
    - appServiceName
    - appServiceImage
    - apiKey
    - provider
  properties:
    appServiceName:
      type: string
      title: App Service Name
      default: construct
    appServiceImage:
      type: string
      title: App Service Image
      default: ghcr.io/kumihoio/construct-os:2026.4.21
    apiKey:
      type: string
      title: LLM Provider API Key
      description: Your API key for the selected LLM provider (e.g. OpenRouter, OpenAI, Anthropic)
      default: ""
    provider:
      type: string
      title: LLM Provider
      default: openrouter
      oneOf:
        - enum:
            - openrouter
          title: OpenRouter
        - enum:
            - openai
          title: OpenAI
        - enum:
            - anthropic
          title: Anthropic
        - enum:
            - ollama
          title: Ollama (Local)

benefits:
  - title: Lightning Fast
    description: Built in 100% Rust with optimized binary size (~15MB). Starts in milliseconds, runs on minimal resources.
  - title: Deploy Anywhere
    description: Runs on Linux (amd64/arm64), macOS, Windows, Raspberry Pi, and Android. Multi-arch Docker images included.
  - title: Provider Agnostic
    description: Swap between OpenRouter, OpenAI, Anthropic, or local Ollama with a single environment variable change.

features:
  - title: Web Dashboard
    description: Built-in web UI for chatting with your AI assistant, accessible via the gateway port.
  - title: Multi-Channel
    description: Connect to Discord, Telegram, Matrix, Slack, WhatsApp, Nostr, Lark, and more simultaneously.
  - title: Persistent Memory
    description: SQLite-backed memory and conversation history that survives restarts.
  - title: Autonomous Tools
    description: File operations, web search, code execution, git operations, and custom skill creation.
  - title: Scheduled Tasks
    description: Built-in cron system for recurring autonomous tasks.
  - title: REST & WebSocket API
    description: Full gateway API for programmatic access and real-time streaming.

tags:
  - AI
  - Self-Hosted
  - Chatbot
  - Agent
  - Assistant
