A Fedora based container that runs OpenChamber (the web UI for opencode) together with a configurable selection of the ArtCraft suite apps.
./run_openchamber_podman.shOpenChamber then runs in the background on http://127.0.0.1:3000
by default. The port and the UI password come from container.conf; the
OPENCHAMBER_UI_PASSWORD environment variable overrides the password from the
file.
The script recreates the container on every start, so only the bind-mounted
directories of this repository survive it: projects holds the project
files, data_opencode the opencode sessions (chats) and database,
config_openchamber the configuration, plus the read-only config_ssh and
config_gitconfig.
run_openchamber_podman.sh rebuilds the image on every start, so everything in
it is decided at build time:
- Base packages (always): curl, git, tar, gzip, bzip2, procps-ng, libatomic
- Node via nvm:
NODE_VERSIONis the default version for opencode and openchamber,EXTRA_NODE_VERSIONSinstalls more.nvm use <version>switches, and a.nvmrcin a project directory is honored oncd. - Python via uv: uv itself is always installed;
PYTHON_VERSIONis the default and also backsUV_PYTHONand thepython3/pythonlinks,EXTRA_PYTHON_VERSIONSinstalls more. - opencode and @openchamber/web
- ArtCraft apps from
artcraft-apps.conf, registered as MCP servers
node-versions.conf and python-versions.conf are required: the script exits
when one is missing or leaves its version empty, and the Dockerfile has no
default version either, so the image cannot be built with a guessed version.
Anything else you want preinstalled — further dnf packages, other toolchains,
extra MCP servers — goes into the Dockerfile the same way and appears after
the next rebuild.
Four config files in this directory are read on startup:
| File | Purpose |
|---|---|
container.conf |
Port and UI password of the running container |
node-versions.conf |
Node version for opencode and openchamber, plus additional versions |
python-versions.conf |
Default python version for uv, plus additional versions |
artcraft-apps.conf |
ArtCraft suite apps to install and register as MCP servers |
container.conf and artcraft-apps.conf are optional, the script supplies
their defaults. The two version conf files are not: they define the only place
where the Node and Python versions are written down.
python-versions.conf selects the Python versions uv installs:
PYTHON_VERSION="3.13"
EXTRA_PYTHON_VERSIONS=""PYTHON_VERSION is the default: it backs UV_PYTHON, python3 and python.
uv works on the files in /projects right away (uv run, uv sync,
uv pip, uv tool install), and uv python install <version> fetches further
versions at runtime.
artcraft-apps.conf lists the apps to install. The newest release of each app is
downloaded from its GitHub releases page and installed as an RPM, which puts the
app and its *-cli into /usr/bin. Every app is then registered as an MCP
server for opencode in /etc/opencode/opencode.jsonc, so the tools are
available to agents right after the container starts.
The apps work on the files in /projects, which is the projects directory of
this repository.
ARTCRAFT_APPS="pdfcraft wordcraft gridcraft"The MCP entries are generated from artcraft_mcp_templates/, so they stay
adjustable instead of living in a script. A template is the JSON object of one
MCP server:
default.jsoncis used for every app without a template of its own<app>.jsoncreplaces the default for exactly this app
__APP__ and __APP_CLI__ are replaced with the app name and its CLI. A
template has to start with { and end with }; comments in between are fine.
artcraft_mcp_templates/pdfcraft.jsonc for example gives pdfcraft its own
--root, while the other apps fall back to the default without one:
The templates are read when the image is built, so rerun
./run_openchamber_podman.sh after changing one.
{ "type": "local", "command": ["pdfcraft-cli", "mcp", "--root", "/projects"] }