raven.api.chat.get_channel_members built each Open-channel member's row by indexing straight into the Raven User lookup result without checking it was found, unlike the identical branch 10 lines below for non-Open channels. A workspace member whose Raven User record is missing (e.g. left behind by a direct cleanup that skipped RavenUser.on_trash's own cascade) crashes the whole whitelisted endpoint with AttributeError instead of just being omitted. Extracted the row-building into build_member_entry(), which returns None for an unmatched member so both branches skip it the same way. Added raven/tests/test_chat_channel_members.py (pure-function coverage plus an IntegrationTestCase reproducing the stale-membership state) following this repo's existing test conventions. Verified: apps/web vitest (480/480) and tsc -b are unaffected and pass; the new Python tests need a Frappe bench (DB-backed test runner) this sandbox does not have, so they are written to the repo's established IntegrationTestCase pattern but not executed here.
Threads for side discussions · Documents from any Frappe app, in the chat
Every file shared in a channel · Search across channels
Raven
Raven is an open-source chat app for teams, built on the Frappe Framework. It runs on your own Frappe site, so your messages stay in your database and nobody charges you per user.
It lives alongside ERPNext, HR, CRM and Helpdesk, and any document from any Frappe app can be part of the conversation.
Key features
- Channels and direct messages: Public and private channels for teams, projects and topics, grouped into workspaces. Direct messages for everything else.
- Threads: Reply in the channel, or take a side discussion into a thread so it does not drown out everyone else.
- Rich messages: Formatting, mentions, code blocks, polls, emoji and custom reactions.
- Files and previews: Drop in photos, videos and documents. Links show a preview, and every file is listed per channel.
- Search: Find messages, files, links and people across every channel you are in.
- Notifications: Push notifications on the web and on your phone, with quiet hours and per-channel settings. Reminders bring a message back later, and scheduled messages go out at a set time.
- Mobile: iOS and Android apps, plus an installable web app, all on the same site.
Works with your Frappe apps
- Share a document: Paste a link to any document on the site and Raven shows a card with its status and key fields.
- Document notifications: Post to a channel when a document is created, changed or submitted. Set the conditions and the message template without writing code.
- Approve from the chat: Approve, reject or send back a document without leaving the conversation.
- Who is on leave: Leave from Frappe HR shows next to a person's name.
- Bots, webhooks and AI agents: Bots that post and reply, incoming webhooks that post into channels, and agents backed by your own OpenAI or compatible provider.
Under the hood
- Frappe Framework: A full-stack web application framework.
- Frappe React SDK: React hooks for auth, data fetching and realtime with a Frappe backend.
Compatibility
| Raven branch | Frappe branch | Notes |
|---|---|---|
| main | version-15 (15.111 or later), version-16 | Stable |
| develop | version-15 (15.111 or later), version-16, develop | Development |
Getting started
Frappe Cloud
Install Raven on a site from the Frappe Cloud marketplace. Frappe Cloud takes care of hosting, upgrades, backups and support.
Self hosting
Pilot is the recommended way to run Raven on your own server. It installs Frappe, manages sites and backups, and sets up production with nginx and TLS. Pilot needs Frappe v16 or later.
Install Pilot:
curl -fsSL https://raw.githubusercontent.com/frappe/pilot/develop/install.sh | bash
Create a bench and run the setup wizard. The first start prints the URL of the admin wizard.
pilot new main
pilot -b main start
Then add Raven and create a site:
pilot -b main get-app https://github.com/frappe/raven
pilot -b main new-site chat.example.com
pilot -b main install-app chat.example.com raven
Raven opens at https://chat.example.com/raven. See the Pilot production guide for nginx, TLS and process managers.
If you already have a bench, install Raven the usual way:
bench get-app https://github.com/frappe/raven
bench --site your-site install-app raven
Mobile apps
The iOS and Android apps connect to any site running Raven v3 or later. Enter the site address, sign in, and every channel is there, in sync with the web app.
Development
Set up a bench with Pilot or bench, get the app and create a site as above, then turn on developer mode and skip CSRF checks for the site. The second setting is for local development only, since the Vite dev server has no CSRF token.
bench set-config -g developer_mode 1
bench --site raven.localhost set-config ignore_csrf 1
Web app
The web app is a React single page app in apps/web. To work on it with hot reloading, add a .env.local file in apps/web:
VITE_SITE_NAME='raven.localhost'
VITE_SOCKET_PORT=9000
VITE_SOCKET_PORT is the socket.io port of your bench, usually the web port plus 1000. Then start the dev server from the app folder:
cd apps/raven
yarn
yarn dev
The app runs at http://raven.localhost:8080 and proxies API calls to your site. Run yarn from the repository root only, not from apps/web.
Contributing
- GitHub Issues: Bug reports. Include steps to reproduce, screenshots and any console or server errors.
- Report security vulnerabilities
- Translations