Jfrazier/docker (#52)

* add docker file

* update docs to reflect using docker

Author: jfdev001

.dockerignore

@@ -0,0 +1,19 @@
+.venv
+.venv_lingua_loop
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info
+.git
+.gitignore
+.github
+.hypothesis
+.pytest_cache
+docs/
+node_modules/
+tests/
+*.db
+.env
+.envrc
+uv.lock
+README.md

Dockerfile

@@ -0,0 +1,15 @@
+FROM python:3.12-slim
+
+RUN pip install uv
+
+WORKDIR /app
+
+COPY pyproject.toml .
+COPY src/ src/
+
+RUN uv sync --no-default-groups
+
+EXPOSE 49152
+
+ENV PATH="/app/.venv/bin:$PATH"
+CMD ["lingua-loop"]

README.md

@@ -243,6 +243,24 @@ python -m venv .venv_lingua_loop
 uv pip install git+https://github.com/jfdev001/lingua-loop.git
 ```
 
+### Docker
+
+You can also run `lingua-loop` with Docker. Build the image:
+
+```
+git clone --depth 1 https://github.com/jfdev001/lingua-loop.git
+cd lingua-loop
+docker build -t lingua-loop .
+```
+
+Then run the container:
+
+```
+docker run -p 49152:49152 lingua-loop
+```
+
+> **Note:** The browser auto-open feature does not work inside a container. Manually open http://localhost:49152 in your browser.
+
 # References
 
 Below are a series of references, in no particular order, that I used to gain

docs/index.rst

@@ -52,6 +52,19 @@ For a faster install using the ``uv`` package manager:
 
    uv pip install git+https://github.com/jfdev001/lingua-loop.git
 
+Using Docker:
+
+.. code-block:: bash
+
+   git clone --depth 1 https://github.com/jfdev001/lingua-loop.git
+   cd lingua-loop
+   docker build -t lingua-loop .
+   docker run -p 49152:49152 lingua-loop
+
+.. important::
+   The browser auto-open feature does not work inside a container.
+   Manually open http://localhost:49152 in your browser.
+
 .. note::
    This package is under active development and updated frequently.
 

src/lingua_loop/scripts/run.py

@@ -22,7 +22,7 @@ def run():
         print(f"Making {DATABASE_DIR}")
         mkdir(DATABASE_DIR)
 
-    host = "127.0.0.1"
+    host = "0.0.0.0"
     free_port = 49152
     threading.Timer(
         2.0, lambda: webbrowser.open(f"http://{host}:{free_port}")