Skip to main content
Welcome to NekoHub. Upload and manage image assets, serve them through a public gallery, and automate workflows via the REST API or MCP endpoint.

Quick Start

Get NekoHub running and upload your first image in minutes.

API Reference

Explore all public endpoints with request and response examples.

Storage Providers

Connect local storage, S3-compatible buckets, or GitHub repos.

MCP Integration

Use NekoHub as a tool in your AI agent workflows via the MCP endpoint.

​
How NekoHub works

NekoHub has two front-end surfaces and one shared backend:
  • Public gallery (/gallery) — anyone can browse images you’ve marked as public, no login required
  • Admin console (/assets, /providers, /settings, etc.) — manage assets, users, storage, and AI providers after logging in
  • REST API / MCP — automate uploads, queries, and processing from scripts or AI agents
1

Deploy NekoHub

Start NekoHub with Docker Compose. Set your database connection, JWT secret, and initial admin credentials.
2

Log in to the admin console

Open http://localhost:5173/login and sign in with your SuperAdmin credentials.
3

Upload your first image

Go to /assets and upload an image. Toggle Public to make it appear in the gallery.
4

Share or integrate

Share the public gallery URL, call the REST API from your application, or connect an AI agent via the MCP endpoint.

​
Key features

Public Gallery

Serve publicly visible assets to anonymous visitors without any authentication.

Role-Based Access

Create users with scoped permissions — control who can upload, delete, or administer.

AI Skills

Run AI enrichment on assets: auto-generate captions, alt text, and structured metadata.

Multi-Provider Storage

Store assets on local disk, any S3-compatible service, or directly in a GitHub repository.