Documentation

Personal AI Kukku Me Platform Guide

Public technical guide for teams using Kukku as an on-device AI platform, with practical operational details and no sensitive implementation internals.

Personal AI Kukku Me App Docs

Platform Model

  • Available on iOS and macOS (awaiting Apple App Review).
  • Agent-first architecture for specialized workflows.
  • On-device-first processing with optional external tools.
  • Modular capabilities: tools, documents, nearby collaboration, profile and backup.

Routing and Execution

  • Analyzer mode required for tool orchestration and planned multi-tool workflows.
  • Direct mode provides low-latency direct responses only; tool flows are disabled.
  • Optional deterministic workflow sequencing per agent.
  • Keyword-guided tool selection with rule-based safeguards.

Premium Subscription: Required for Analyzer mode and all tool orchestration.

Model Setup and Memory Planning

  • Higher-memory configurations can expose 4B parameter models quantized to 8-bit.
  • These larger 4B model options are not shown in iOS model picker.
  • On lower-memory devices, use the default low-memory model profile.
  • Selecting oversized models on low-memory devices can cause unpredictable responses and app instability, including possible crashes due to memory pressure.

Output synthesis controls: Advanced settings (temperature, top-p, repetition controls, output token limits) directly affect response style and length. For practical tuning steps, see User Guide and Tools Guide.

Recommendation: Keep the default low model selection on lower-memory devices unless you have validated stability for your workload.

Tool Enablement

  • Tools are attached per agent, not globally assumed.
  • Credential-backed tools require valid provider setup.
  • Tool packs can be imported to expand agent capability sets.
  • Operational checks should include permissions + credentials + assignment.

Knowledge Workflows

  • Supported file types: PDF, images, text.
  • Document processing must complete before reliable retrieval.
  • Comparison queries should reference both source documents explicitly.

Nearby Agents

  • Peer discovery, secure pairing, and remote agent bridging to dashboard.
  • Password-based secure connection flow.
  • Designed for local collaboration and handoff workflows.

Premium Subscription: Required for Near By Kukku Agents.

Nearby Bots (OpenClaw Compatible)

  • Local gateway discovery and approval flow via gateway token.
  • Remote bot-agent listing and add-to-dashboard bridging.
  • No special Wi-Fi SSID naming requirement.

Premium Subscription: Required for Near By Kukku Bots. Operational requirement: bot gateway must be discoverable on local network and approved in the app flow before agent listing.

Quick Agent Setup

  • Quick Agent Setup accelerates creation with guided defaults and tool recommendations.
  • Agent editing supports role/personality refinement and tool/routing updates.
  • Designed for broad device compatibility.

Team Agents

  • Team Agents support multi-agent orchestration for advanced workflows.
  • Recommended on high-memory devices for best performance consistency.

Output Experience

  • Kukku can render specialized result cards (for example health and stock views).
  • Structured output is surfaced in chat alongside natural language responses.
  • Raw protocol traces remain hidden in normal user mode.

Data and Safety

  • Core design prioritizes local processing and user-controlled integrations.
  • Backup/restore supports continuity while protecting secrets.
  • API credentials are redacted from portable backups.