# Nextcloud AI Stack

> Installs, verifies and debugs Nextcloud's AI features end to end: the Assistant frontend, the server's Task Processing engine, and the provider apps behind it (llm2, translate2, stt_whisper2, text2image_stablediffusion2, context_chat) whether they run as local ExApps or as external API integrations. Use for "set up AI on my Nextcloud", "which app provides which task type", "the Assistant shows nothing", "my AI task never finishes", GPU versus CPU decisions, and model storage or download problems.

- Skill: `nextcloud/nextcloud-ai-stack` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add nextcloud/nextcloud-ai-stack`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nextcloud/nextcloud-ai-stack/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- License: AGPL-3.0-or-later
- Author: nextcloud (https://skillmd.com/u/nextcloud)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nextcloud/nextcloud-ai-stack

---


# The Nextcloud AI stack

Three layers, and almost every support question is really about the boundary between them:

- **Frontends**: Assistant, Talk, Files, Mail. They ask for work, they never compute it.
- **Task Processing**: the scheduler inside the Nextcloud server. It owns task types, picks a provider,
  queues the task and runs it through background jobs.
- **Providers**: the apps that actually compute. Either local ExApps deployed through AppAPI (llm2,
  translate2, stt_whisper2, text2image_stablediffusion2, context_chat_backend) or integrations that call an
  external API (integration_openai and friends).

"AI does nothing" almost always means no provider is registered for the task type the frontend asked for.

## How to work

1. Installing or extending the stack: [references/ai-stack.md](references/ai-stack.md). It has the install
   order, the acceptance checks, and the model storage and GPU facts that decide your hardware.
2. Something is broken: [references/ai-troubleshooting.md](references/ai-troubleshooting.md), which starts
   from the symptom and the one command that splits the problem in half.
3. Collect state first: [assets/ai-doctor.sh](assets/ai-doctor.sh) prints registered task types, provider
   apps, ExApp init progress, stuck tasks and background-job health.

## Facts that save hours

- The provider list is the ground truth: `GET /ocs/v2.php/taskprocessing/tasktypes` returns **only task types
  that currently have a provider**. If `core:text2text` is absent, no amount of Assistant debugging helps.
  It is cached for 60 seconds, so re-query once before believing a short list.
- A provider whose task loop crashed still answers heartbeats, still registers its providers and still shows
  its task types. "Healthy" proves nothing; the proof is whether it calls
  `taskprocessing/tasks_provider/next`.
- `occ app_api:app:list` prints `[enabled]` from registration onwards, which does **not** mean the app is
  ready. A provider ExApp registers its providers only after `/init` completes, and init is where multi-GB
  model downloads happen (verified: llm2 sat at init 15% with the app already listed as enabled).
- Model downloads live in the ExApp's persistent volume. `app_api:app:unregister --rm-data` deletes them and
  costs you the whole download again.
- Task Processing runs through background jobs: if cron is broken, tasks stay `scheduled` forever and nothing
  in the AI apps is at fault.
- Compute device is a property of the **daemon**, not the app: register the daemon with
  `--compute_device cuda|rocm` before deploying GPU providers.
- On the Nextcloud 35 line, several AI ExApps have no release in the app store feed yet, so they install from
  a manifest instead of the store.

## Files

- [references/ai-stack.md](references/ai-stack.md): install, verify, operate, size.
- [references/ai-troubleshooting.md](references/ai-troubleshooting.md): symptom-first diagnosis.
- [assets/ai-doctor.sh](assets/ai-doctor.sh): read-only state collector.
- Deploying and managing the provider ExApps themselves:
  [exapp-operations](../exapp-operations/SKILL.md). Changing one of them:
  [exapp-maintenance](../exapp-maintenance/SKILL.md). Writing a provider:
  [exapp-development](../exapp-development/SKILL.md).