civitai

逛模型、传模型、找灵感,一站式 AI 绘画社区。

Civitai 是一个面向 Stable Diffusion 等 AI 图像生成模型的社区平台,其开源仓库主要包含前端和后端代码。它解决了模型创作者与使用者之间缺乏集中发现、分享和协作渠道的问题。核心能力包括:模型仓库管理(支持模型、文本反转等资源的上传与浏览)、用户系统、模型版本追踪、社区互动(点赞、评论、收藏)、以及基于标签和分类的搜索筛选。作为成长中的项目,它已成为 AI 绘画领域重要的模型分发和社区交流基础设施。

开源 freemium 图像生成
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 7256
维护状态 活跃
是否开源 是
定价模式 freemium

项目数据

分类图像生成
开发团队civitai
所属国家
定价模式freemium
价格说明提供免费模型浏览和下载,高级功能或更多资源需付费订阅。
访问状态
是否开源是
开源协议Apache-2.0
主要语言TypeScript
技术栈/模型ai,social-network,stable-diffusion
GitHub 星标★ 7256
30天Star增速
HF 下载量
上线时间2022-10-11 00:00:00
最近更新2026-09-22 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数2

使用教程

难度:进阶 约 15 分钟 部署方式:本地安装 8 步

环境要求

  • Node.js 24.19.0(由项目根目录 .nvmrc 指定,需配合 nvm 使用)
  • 已安装 nvm,用于按 .nvmrc 切换 Node 版本
  • 已启用 corepack 以使用 pnpm 包管理器
  • 已安装 Docker 与 Docker Compose(用于启动 Postgres 等基础服务)
  • Git,且需支持 submodule 拉取

安装与启动步骤

  1. 1克隆仓库

    把 civitai 源码克隆到本地并进入项目根目录,后续所有命令都在该目录执行。

    git clone https://github.com/civitai/civitai.git
    cd civitai
  2. 2切换 Node 版本

    nvm use 会读取项目里的 .nvmrc,自动切换到 README 指定的 Node 24.19.0,版本不符会导致安装失败。

    nvm use
  3. 3启用 corepack

    corepack enable 让系统能够使用项目声明的包管理器(pnpm),否则后续 pnpm 命令不可用。

    corepack enable
  4. 4拉取子模块

    项目依赖 event-engine-common 子模块,需显式初始化拉取,否则构建会缺文件。

    git submodule update --init event-engine-common
  5. 5生成环境变量文件

    从仓库自带的 .env-example 复制出 .env.development,作为本地开发环境变量配置。

    cp .env-example .env.development
  6. 6启动基础服务

    用 Docker Compose 拉起项目依赖的基础服务(如 Postgres 数据库),必须保持后台运行。

    docker compose -f docker-compose.base.yml up -d
  7. 7安装依赖

    pnpm install 安装前后端全部 npm 依赖,首次执行耗时较长,需联网。

    pnpm install
  8. 8启动开发服务

    pnpm dev 启动 Next.js 开发服务器,前后端一起跑;保持终端不关闭即可访问本地服务。

    pnpm dev

关键配置

配置项必填说明示例
.env.development是本地开发环境变量文件,由 .env-example 复制而来,README 未列出具体键值,请按需自行填写.env.development

如何确认成功

执行 pnpm dev 后终端不再报错、输出开发服务器编译/就绪日志,且 docker compose 拉起的容器处于运行状态,即表示本地环境启动成功。

常见问题

Q:执行 pnpm 提示命令不存在怎么办?

A:先在项目根目录执行 corepack enable 启用包管理器,再运行 pnpm install;同时确认已通过 nvm use 切到 .nvmrc 指定的 Node 24.19.0。

Q:Node 版本不是 24.19.0 会影响吗?

A:会影响。README 用 nvm use 读取 .nvmrc 将版本固定为 24.19.0,请先安装并使用该版本,再执行安装与启动命令。

Q:启动时报缺少 event-engine-common 相关文件?

A:说明子模块没拉取,执行 git submodule update --init event-engine-common 后重新运行 pnpm install。

Q:数据库连不上或启动后报数据层错误?

A:确认已执行 docker compose -f docker-compose.base.yml up -d 启动基础服务,并检查 .env.development 中的连接配置是否与容器一致。

Q:访问什么地址查看站点?

A:README 未给出具体端口和访问地址,请以 pnpm dev 终端输出的地址为准。

注意事项

  • 命令顺序不能随意调整:先 nvm use 与 corepack enable,再安装依赖与启动服务。
  • docker compose -f docker-compose.base.yml up -d 必须在 pnpm dev 之前执行,否则应用无法连接数据库。
  • README 只提供 Standard setup 一种本地安装方式,未提供 Docker 一键部署镜像或云部署说明。
  • README 未给出默认端口、访问地址及 .env 具体配置项,请勿照搬网上其他版本的参数。

核心亮点

  • 模型资源丰富,分类清晰,搜索筛选体验好
  • 支持模型版本管理,方便创作者迭代和用户追溯
  • 社区互动功能完善,点赞评论收藏一应俱全

不足之处

  • 部署依赖较多,本地搭建环境门槛较高
  • 文档/社区待观察

适用场景

  • AI 绘画爱好者寻找和下载特定风格的模型
  • 模型创作者发布作品并收集用户反馈
  • 开发者基于其开源代码构建定制化模型分享平台

替代项目

Hugging Face、ModelScope、Replicate

项目介绍

civitai 是开源模型领域的开源项目,由 civitai 开发,2022 年首次发布。

在全站 13,090 个收录项目中,它的 GitHub 星标数(7,256)位列前 7%,在开源模型分类的 424 个项目里位列前 10%。

近 41 天,它的 GitHub 星标从 7,216 增加到 7,256,净增 40。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-22。提供免费模型浏览和下载,高级功能或更多资源需付费订阅。从国内网络环境看,当前已无法正常访问。

它主要面向的使用场景是:AI绘画爱好者寻找和下载特定风格的模型。同类可对比的替代方案包括 Hugging Face、ModelScope、Replicate。

上一篇:i1

下一篇:AGI-Papers

同类项目推荐

Machine-Learning 开源

跟着博客笔记,边看边跑机器学习代码

All content related to machine learning from my blog

★ 115 2026-08-09
CoreML-Models 开源

下载即用的苹果端 AI 模型库,免去转换烦恼

Core ML model zoo for iOS/macOS — PyTorch models converted to ready-to-use .mlpacka···

★ 1873 2026-08-10