JIN Core Engine v1.0

.dockerignore

@@ -0,0 +1,30 @@
+.git
+.github
+.idea
+.vscode
+.venv
+.pytest_cache
+**/__pycache__
+**/*.py[cod]
+node_modules
+
+# Local secrets and machine-specific config are injected at runtime.
+.env
+.env.*
+!.env.example
+config.py
+
+# Local/dev artifacts.
+*.zip
+*.patch
+repomix-output.xml
+.codegraph
+pack_for_patch.bat
+
+# Runtime state is mounted from the host by compose.yml.
+memory
+logs
+logs_anon
+assets/files/*
+!assets/files/.gitkeep
+assets/outputs

.env.example

@@ -0,0 +1,5 @@
+# Copy this file to .env and replace the placeholders with local secrets.
+# launch_jin.bat / launch_jin.ps1 loads the root .env into the JIN process.
+
+SEARCH_SERPER_API_KEY=your-serper-api-key
+GETPOSTINGBOARD_API_KEY=your-getpostingboard-api-key

.gitignore

@@ -7,6 +7,7 @@ env/
 
 .env
 .env.*
+!.env.example
 config.py
 
 .idea/
@@ -18,9 +19,35 @@ repomix-output.xml
 init.py
 saved_runtime.txt
 *.patch
+pack_for_patch.bat
 
 assets/*
 !assets/skills/
 !assets/skills/**
 
-.gitkeep
+# Memory contents
+memory/**/*.json
+logs/*
+!logs/.gitkeep
+logs/**/*
+!logs/**/
+!logs/**/.gitkeep
+logs_anon/*
+!logs_anon/.gitkeep
+logs_anon/**/*
+!logs_anon/**/
+!logs_anon/**/.gitkeep
+
+# Keep empty memory directory structure
+!memory/**/.gitkeep
+# Atomic memory write leftovers
+memory/**/*.tmp
+
+# JIN persistent attachment library (runtime data)
+!assets/files/
+assets/files/*
+!assets/files/.gitkeep
+
+# Windows launcher runtime/cache data
+.jin_launcher/
+.jin_runtime/

CONTRIBUTING.md

@@ -47,4 +47,4 @@ Before opening a PR:
 
 ## Project direction
 
-JIN Core is focused on runtime continuity for local LLMs: memory layers, visible process state, feedback signals, and a UI that helps the human and the model stay synchronized.
+JIN Core is focused on runtime continuity for OpenAI-compatible models, especially local runtimes: memory layers, visible process state, feedback signals, and a UI that helps the human and the model stay synchronized.

Dockerfile

@@ -0,0 +1,30 @@
+FROM python:3.12-slim
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    PIP_NO_CACHE_DIR=1
+
+WORKDIR /app
+
+COPY requirements.txt ./
+RUN python -m pip install --no-cache-dir -r requirements.txt
+
+COPY . .
+
+# These paths contain runtime state and are normally bind-mounted by Compose.
+RUN mkdir -p \
+    /app/memory \
+    /app/logs \
+    /app/logs_anon \
+    /app/assets/files \
+    /app/assets/outputs
+
+ENV JIN_HOST=0.0.0.0 \
+    JIN_PORT=8000
+
+EXPOSE 8000
+
+HEALTHCHECK --interval=30s --timeout=3s --start-period=10s --retries=3 \
+    CMD python -c "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8000/', timeout=2)"
+
+CMD ["python", "app.py"]

JIN_LAUNCHER.bat

@@ -0,0 +1,17 @@
+@echo off
+setlocal
+chcp 65001 >nul
+cd /d "%~dp0"
+title JIN CORE ENGINE // LAUNCHER
+mode con cols=92 lines=55 >nul 2>nul
+
+powershell.exe -NoProfile -ExecutionPolicy Bypass -File "%~dp0jl.ps1"
+set "JIN_EXIT=%ERRORLEVEL%"
+
+if not "%JIN_EXIT%"=="0" (
+  echo.
+  echo JIN launcher stopped with error %JIN_EXIT%.
+  pause
+)
+
+exit /b %JIN_EXIT%