From: Edward Delaporte <edward@delaporte.us>
Date: Sat, 28 Mar 2026 01:09:57 +0000 (-0500)
Subject: Add usage
X-Git-Url: https://us-delaporte.pagekite.me/gitweb/matrix-cadbury.git/commitdiff_plain/da155a5cf1def9d13f81c2f3719721498245539c

Add usage
---

diff --git a/README.md b/README.md
index e28db46..1b48dfd 100644
--- a/README.md
+++ b/README.md
@@ -4,17 +4,35 @@ Cadbury is a friendly composable multi-purpose Matrix bot.
 
 See `pyproject.toml` for the dependencies.
 Note that each dependency provides a separate dedicated bot role.
-Bots roles are composed in `app.py` before connecting to the Matrix server.
+Bots roles are composed with a couple lines of code in `app.py` before connecting to the Matrix server.
 
 Although each bot role can run separately with separate credentials,
 the purpose of `Cadbury` is to compose several together under a single Matrix bot login.
 
+## Getting Started
+
+Create a bot account on your Matrix server, and set the necessary environment variables: `MATRIX_SERVER`, `MATRIX_BOT`, `MATRIX_BOT_PWD`.
+
+> Tip: Cadbury has no use for email. Your Matrix server may allow creating the bot account without an email account, using a `token` registration type.
+
+Run the bot with `make serve`,
+or build a virtual environment and then run the bot with
+
+Or run the following commands to create the virtual environment:
+
+	python -m venv .venv
+	.venv/bin/pip install .
+
+Then use the following command to launch the bot:
+
+	.venv/bin/python app.py
+
 ## Remixing
 
 When creating your own unique mix of bot roles, consider creating a public fork of
 this repository and modifying `app.py` and `pyproject.toml` as needed.
 
-Note that the AGPLv3 license, and please share your own modifications publicly, if you choose to use a modified version of this bot in a public setting.
+Note the AGPLv3 license, and please share your own modifications publicly, if you choose to use a modified version of this bot in a public setting.
 
 ## About the Name