Instructions to use jpanasuk/basecamp with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- HERMES
How to use jpanasuk/basecamp with HERMES:
# No code snippets available yet for this library. # To use this model, check the repository files and the library's documentation. # Want to help? PRs adding snippets are welcome at: # https://github.com/huggingface/huggingface.js
- Notebooks
- Google Colab
- Kaggle
File size: 3,425 Bytes
dc6355d db81b0e dc6355d db81b0e dc6355d 2b69294 dc6355d 6093073 2b69294 6093073 dc6355d | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 | FROM ubuntu:22.04
ENV DEBIAN_FRONTEND=noninteractive
ENV OLLAMA_HOST=0.0.0.0:11434
ENV OLLAMA_MODELS=/root/.ollama/models
ENV BASECAMP_MODEL=llama3.1:8b
# ββ System deps ββ
# xz-utils is required by the Hermes installer (Node.js .tar.xz archive)
# The FIXER TOOLBOX: every CLI basecamp hermes needs to actually EXECUTE
# fixes, not just describe them (databases, docker, yaml, networking).
RUN apt-get update && apt-get install -y --no-install-recommends \
python3 python3-pip curl wget git ca-certificates xz-utils zstd \
supervisor procps jq gnupg \
# database clients β postgres/pgvector, sqlite, redis
postgresql-client sqlite3 redis-tools \
# docker CLI + compose plugin (for managing the stack when the
# docker socket is mounted into basecamp)
docker.io docker-compose-v2 \
# network diagnostics β the fixer must be able to SEE the network
iputils-ping dnsutils netcat-openbsd lsof \
# misc surgical tools
htop unzip file \
&& rm -rf /var/lib/apt/lists/* \
# yq (yaml editor) β not in Ubuntu 22.04 apt; official static binary
&& curl -fsSL -o /usr/local/bin/yq "https://github.com/mikefarah/yq/releases/latest/download/yq_linux_amd64" \
&& chmod +x /usr/local/bin/yq \
# mongosh (mongo shell) β 'mongodb-clients' doesn't exist on 22.04;
# install the official shell from MongoDB's apt repo instead.
&& curl -fsSL https://www.mongodb.org/static/pgp/server-7.0.asc | gpg --dearmor -o /usr/share/keyrings/mongodb.gpg \
&& echo "deb [signed-by=/usr/share/keyrings/mongodb.gpg] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/7.0 multiverse" > /etc/apt/sources.list.d/mongodb.list \
&& apt-get update && apt-get install -y --no-install-recommends mongodb-mongosh \
&& rm -rf /var/lib/apt/lists/*
# ββ Install Ollama ββ
RUN curl -fsSL https://ollama.com/install.sh | sh
# ββ Install Hermes Agent ββ
# Official installer (root-mode FHS layout -> /usr/local/bin/hermes, data -> /root/.hermes).
# WARNING: do NOT `pip3 install hermes-cli` β that PyPI package is an unrelated
# 0.0.1.x stub, NOT Hermes Agent. Use the official installer only.
# --skip-browser keeps the image lean; browser tooling can be added later.
RUN curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-browser
ENV PATH="/usr/local/bin:/root/.local/bin:${PATH}"
# ββ Basecamp discovery + tools ββ
RUN mkdir -p /opt/basecamp
COPY discover.py /opt/basecamp/discover.py
COPY recipes.py /opt/basecamp/recipes.py
COPY tavern.sh /opt/basecamp/tavern.sh
COPY tavern_mcp.py /opt/basecamp/tavern_mcp.py
COPY skins/ /opt/basecamp/skins/
COPY SOUL.md /opt/basecamp/SOUL.md
RUN chmod +x /opt/basecamp/discover.py /opt/basecamp/tavern.sh /opt/basecamp/tavern_mcp.py
# ββ MCP SDK β required by hermes's native MCP client to connect to the
# tavern MCP server (tavern_mcp.py) and expose the connectivity toolkit
# as first-class tools (mcp_tavern_status, self_check, wire, ...). ββ
RUN pip3 install --no-cache-dir --break-system-packages mcp 2>/dev/null \
|| pip3 install --no-cache-dir mcp
# ββ Supervisor config (Ollama only β Hermes is exec'd by the entrypoint) ββ
COPY supervisord.conf /etc/supervisor/conf.d/supervisord.conf
# ββ Entrypoint ββ
COPY entrypoint.sh /entrypoint.sh
RUN chmod +x /entrypoint.sh
EXPOSE 11434
WORKDIR /root
ENTRYPOINT ["/entrypoint.sh"]
|