TaskNebula

The open-source project management system with a real AI copilot

A self-hosted issue tracker that feels like Linear, scales like Jira, and drafts work with you like a pair programmer. Bring your own OpenAI / Anthropic key — or run fully offline with the native planner.

Docker Hub · Quick start · AI · Features · Report a bug

Draft issues from a prompt	Per-issue AI assist
Real-time Kanban board	Workspace dashboard

One curl, then open your browser:

curl -fsSL https://raw.githubusercontent.com/neuraparse/tasknebula/main/scripts/quickstart.sh | bash

The script pulls neuraparse/tasknebula:latest, spins up Postgres + Redis

• LiveKit via Docker Compose, generates a strong AUTH_SECRET, and opens http://localhost:3000. First-run wizard creates your admin account.

git clone https://github.com/neuraparse/tasknebula.git
cd tasknebula
cp .env.example .env
echo "AUTH_SECRET=$(openssl rand -base64 32)" >> .env
docker compose up -d --build

# default is :latest
TASKNEBULA_IMAGE=neuraparse/tasknebula:0.2.4 docker compose up -d

AI is off by default. Enable it per workspace from Settings → AI & Agents in under 30 seconds. Everything is DB-managed — no env vars to redeploy when you rotate a key.

Every failure — bad key, rate limit, model not available — becomes an in-app notification with a Sparkles/Bot icon, a one-line action hint ("Open Settings → AI & Agents to add a key"), and a deep-link straight to the relevant project AI settings. Full audit trail in Admin → Audit logs.

# .env
APP_URL=https://tasks.yourcompany.com
AUTH_SECRET=your-secret-here   # openssl rand -base64 32

Put any reverse proxy in front for SSL. Caddy is the easiest:

tasks.yourcompany.com {
    reverse_proxy localhost:3000
}

See .env.example for the full list — SMTP, OAuth, LiveKit tuning, optional platform LLM keys, etc. Everything AI-related can be configured through the UI after first boot; env vars are only a fallback for dev.

LiveKit ships plain ws:// on port 7880. A production browser loading TaskNebula over https:// refuses mixed-content wss:// without TLS in front. Put nginx (or Caddy) on its own subdomain:

1. DNS: add livekit.your-domain.example.com → same server IP as the app.
2. nginx: copy the ready template at nginx/tasknebula-livekit.conf, replace the hostname, then:

   sudo certbot --nginx -d livekit.your-domain.example.com
   sudo nginx -t && sudo nginx -s reload

3. .env:

   NEXT_PUBLIC_LIVEKIT_URL=wss://livekit.your-domain.example.com

4. Rebuild so the build-time env is baked into the Next bundle:

   docker compose up -d --build web

The template terminates TLS, forwards to 127.0.0.1:7880, and keeps the WebSocket upgrade headers + 24h idle timeout LiveKit needs.

docker compose up -d                  # Start (pulls :latest)
docker compose down                   # Stop
docker compose logs -f web            # Tail the web service
docker compose pull web && \
  docker compose up -d                # Update to the newest image
docker compose up -d --build          # Rebuild from local source
git pull && docker compose up -d --build   # Pull + rebuild

docker-compose.yml defaults to image: neuraparse/tasknebula:latest. Set TASKNEBULA_IMAGE=neuraparse/tasknebula:0.2.4 in .env to pin.

pnpm install
docker compose up -d postgres redis
cp .env.example .env
cp apps/web/.env.example apps/web/.env.local
cd packages/db && pnpm tsx scripts/migrate.ts && cd ../..
pnpm dev

Run the full test suite:

pnpm --filter @tasknebula/web exec jest

AI-related tests live under apps/web/src/lib/ai/__tests__, apps/web/src/lib/agents/__tests__, and apps/web/src/app/api/ai/**/__tests__.

Pull requests welcome. See CONTRIBUTING.md for the branch model, commit conventions, and how to run the linter + tests locally before pushing.

MIT — see LICENSE.