AI for selfhost

[forehalo]

There are too many questions regarding AFFiNE AI support for selfhost instances and some of them are outdated.
Let's make this one as the official QA and progress tracking for all the concerns.
I will pin this on top of issues panel, the old ones or new comings will be closed directly and leave a ref to this issue.

Progress

• unbind actions with specified models
• support my own keys in admin panel
• support custom providers(ollama, deepseek, ...)
• more...

[forehalo]

Can I enable the AI in an unofficial way now in my instance?

The answer is yes.

Steps for those using provided compose file:

1. create a JSON config at ${CONFIG_LOCATION}/config.json

If you are using an editor that supports JSON lsp, the "$schema" field with provide you fully commented fields auto-complete

{
  "$schema": "https://github.com/toeverything/affine/releases/latest/download/config.schema.json",
  "copilot": {
    "enabled": true,
    "providers.openai": {
      "apiKey": "your key",
      "baseUrl": "open-ai-compatitable.example.com"
    }
  }
}

2. restart your host

docker compose up -d

Steps for custom deployment:

1. create a JSON config

{
  "$schema": "https://github.com/toeverything/affine/releases/latest/download/config.schema.json",
  "copilot": {
    "enabled": true,
    "providers.openai": {
      "apiKey": "your key",
    }
  }
}

2. Mount or Copy the config file to your instance

3. import the config

node --import ./scripts/register.js ./dist/data/index.js import-config ./path/to/config.json

4. restart your host

[ssly]

Can I enable the AI in an unofficial way now in my instance?

现在能否以非官方方式在我的实例中启用 AI？
The answer is yes.答案是肯定的。

Steps for those using provided compose file:

1. create a JSON config at ${CONFIG_LOCATION}/config.json1. 在 ${CONFIG_LOCATION}/config.json 创建一个 JSON 配置文件

If you are using an editor that supports JSON lsp, the "$schema" field with provide you fully commented fields auto-complete如果您使用的是支持 JSON lsp 的编辑器，"$schema"字段将为您提供带有完整注释的字段自动完成功能

{
"$schema": "https://github.com/toeverything/affine/releases/latest/download/config.schema.json",
"copilot": {
"enabled": true,
"providers.openai": {
"apiKey": "your key",
"baseUrl": "open-ai-compatitable.example.com"
}
}
}
2. restart your host  2. 重启主机

docker compose up -d

Steps for custom deployment:

1. create a JSON config1. 创建 JSON 配置文件

{
"$schema": "https://github.com/toeverything/affine/releases/latest/download/config.schema.json",
"copilot": {
"enabled": true,
"providers.openai": {
"apiKey": "your key",
}
}
}
2. Mount or Copy the config file to your instance2. 将配置文件挂载或复制到您的实例

3. import the config  3. 导入配置

node --import ./scripts/register.js ./dist/data/index.js import-config ./path/to/config.json
4. restart your host  4. 重启您的宿主

How can I configure DeepSeek? How to set up the model. Moreover, in the 0.21.2 management panel, the AI function cannot be activated.

[forehalo]

That why I called the solution in #11691 (comment) is "unofficial". to configure AI functionality in Admin panel is still work in progress.

Regarding using DeepSeek, it's concurrently not supported yet, but I think it will be available with AI admin panel together

[MrSquaare]

Hello!

Thanks for the tips for selfhosted instance

Will there be AI support for local workspace?

[forehalo]

You can only use simple actions in local workspace like random chat, translation. The actions with context awareness, for example embedding, can not be used with local workspaces, because the server doesn't know the content of your local workspace

[daydaya]

好像仍然有10次的使用限制，我使用自己的 API key 进行配置，并在openrouter后台看到了使用记录，但是affine中的AI仍然只能使用10次

[vladkor97]

Turn on unlimited AI for yourself in your admin panel

[daydaya]

Wow, it's really possible! In the account settings, click on modify, and you can see the options, thank you very much 🙏

[vladkor97]

You're welcome :)

[ssly]

Wow, it's really possible! In the account settings, click on modify, and you can see the options, thank you very much 🙏哇，这真的可能！在账户设置中，点击修改，你可以看到选项，非常感谢 🙏

你使用的是什么模型，我这边这个管理员面板的 AI 按钮无法开启，是禁用状态

[Kosette]

@ssly 使用OpenAI兼容的API以及正确的apikey没有问题，服务启动时会检测API的可用性，可以查看日志。如果没有办法开启AI可能是配置有误。理论上还支持其他的AI provider，具有可用性可查看对应的源代码。

[boom404]

I created for myself a small server between Affine and Gemini or OpenRouter, who provides free API keys. Not sure if this allowed here in this chat.
My solution is implemented to start as normal docker container. "Ask AI" is working as expected

https://github.com/boom404/affine-copilot-fix

[floli]

Since recently, I get this error message when trying to use it:

affine-1            | [Nest] 1  - 04/21/2025, 5:41:17 PM   ERROR [Sse] <selfhosted:http:1e2dbb90-d47a-40c6-a6a3-c9ffb4663273> no_copilot_provider_available ({"sessionId":"75d47f52-93b1-4bac-acc7-be9913cbc7e8","params":{},"throwInStream":false})
affine-1            | no_copilot_provider_available: No copilot provider available.
affine-1            |     at CopilotController.chooseTextProvider (file:///app/dist/plugins/copilot/controller.js:59:19)
affine-1            |     at process.processTicksAndRejections (node:internal/process/task_queues:105:5)
affine-1            |     at async CopilotController.chatStream (file:///app/dist/plugins/copilot/controller.js:161:30)
affine-1            |     at async CopilotController.<anonymous> (file:///app/dist/base/metrics/utils.js:20:20)

My relevant config.json looks like

{
  "$schema": "https://github.com/toeverything/affine/releases/latest/download/config.schema.json",
  "server": {
    "name": "myname",
    "host": "affine.myname.de",
    "https": true
  },
  "copilot": {
    "enabled": true,
    "providers.openai": {
      "apiKey": "sk-proj-...",
    }
  }
}

Any ideas?

[boom404]

I experienced the same problem. The AI chat in the sidebar wasn't working, but the normal "Ask AI" in documents was fine. I've turned off the "world icon" in the chat sidebar. But, i'm using my own Affine Copilot Fix, because I want to use Gemini - nevertheless, the problem should be maybe the same.

[Baneoflere]

### Struggling to turn your email list into a consistent revenue stream? 📈
Are you tired of sending emails that don't convert? Do you know you should be leveraging email marketing, but aren't sure how to build a truly profitable system?
Building an engaged email list is one thing, but transforming it into a powerful profit-generating machine requires a strategic approach. That's where most businesses hit a wall.
Imagine having a clear, step-by-step blueprint to create email funnels that not only nurture leads but consistently drive sales and maximize your income.
That's exactly what you'll get in our new Ebook, "Email List Profit Funnels: Maximise Your Income With High-Powered Campaigns".
This isn't just another guide; it's your essential roadmap to:

• Building a highly responsive and engaged email list from scratch.
• Designing automated email funnels that convert subscribers into paying customers 24/7.
• Writing compelling email copy that captivates your audience and drives action.
• Scaling your income using proven email marketing strategies.
• Avoiding common pitfalls that cost businesses time and money.
  In today's competitive landscape, a well-optimized email list profit funnel is NON-NEGOTIABLE for sustainable growth. This Ebook cuts through the noise and gives you the actionable strategies you need right now.
  Ready to unlock the full profit potential of your email list?
  Stop guessing and start implementing proven systems. Download your FREE copy of "Email List Profit Funnels" today and begin building your high-powered campaigns!
  👉 Get your instant access here: Https://cutt.ly/CrhueVHR
  Don't miss out on transforming your email marketing from a task into your most profitable asset. Click the link above to get your copy now!
  #EmailMarketing #LeadGeneration #SalesFunnel #DigitalMarketing #MarketingStrategy #BusinessGrowth #EmailListBuilding #ProfitFunnels #MarketingTips #Entrepreneurship #SmallBusiness