Sophon Docs
Channels

WebChat

Built-in browser chat — no setup required.

WebChat is Sophon's built-in chat interface. It runs alongside the Dashboard automatically and requires no configuration.

Features

  • Available at http://localhost:8080/chat as soon as Sophon starts
  • Real-time streaming responses via SignalR
  • File attachments via drag-and-drop, file picker, or clipboard paste
  • Inline image previews and document chips
  • Agent selector for multi-agent setups
  • Full conversation history

Configuration

WebChat has no required configuration. It is always enabled and cannot be disabled.

Optional settings can be adjusted in appsettings.json:

SettingTypeDefaultDescription
MaxMessageLengthint10000Maximum characters per message
MaxFileSizeint26214400Maximum upload size in bytes (25 MB)
MaxFilesPerMessageint10Maximum attachments per message

channels.json Example

WebChat does not appear in channels.json since it is a built-in system channel.

Troubleshooting

  • Chat page shows "Connecting..." — Ensure the Gateway is running on port 8080 and SignalR is not blocked by a reverse proxy or firewall.
  • File uploads fail — Check that the file is under 25 MB and the ~/.sophon/documents/uploads/ directory is writable.
  • No response from agent — Verify that at least one LLM provider is configured and healthy under Settings > Models.