2e56ffc4f5
Maps <site>.docs.ourworld.tf to /<site>/docs/ E.g., geomind_memo.docs.ourworld.tf -> /geomind_memo/docs/ |
||
|---|---|---|
| .claude | ||
| cfg_template | ||
| content | ||
| docker | ||
| docs | ||
| filewidget | ||
| specs | ||
| src | ||
| static | ||
| templates | ||
| .dockerignore | ||
| .dockerignore.bak | ||
| .gitattributes | ||
| .gitignore | ||
| install.sh | ||
| pipenv.sh | ||
| pyproject.toml | ||
| README.md | ||
| start_server.sh | ||
| start_server_debug.sh | ||
| uv.lock | ||
knowledgecenter
Installation & Setup
to test as docker
docker run -p 9922:9922 -v /path/to/content:/content -e ATLAS_CONTENT_PATH=/content atlasserver:latest
to run natively
export ATLAS_CONTENT_PATH="${HOME}/code/forge.ourworld.tf/ourworld/atlas_ourworld"
${HOME}/code/forge.ourworld.tf/lhumina_research/atlasserver/start_server_debug.sh
First Time Setup
./install.sh
This will:
- Install
uvif not present - Create a Python virtual environment
- Install all dependencies from
pyproject.toml - Use local
herolibif available at~/code/forge.ourworld.tf/lhumina_research/herolib_python
Force Update herolib
If you need to update to the latest herolib from git (e.g., after upstream changes):
./install.sh --force
This forces a clean reinstall of herolib from the git repository, bypassing the cache.
Starting the Server
Production mode:
./start_server.sh
Server runs on port 9922 at http://localhost:9922
Development mode:
./start_server_debug.sh
Runs with debug mode enabled and auto-reload on code changes.
ngrok
to be able to test on own environment
ngrok login
ngrok http 9022
it lets me expose a local development server to the internet, which is useful for testing webhooks and other integrations.
example url https://e68c72dd903a.ngrok-free.app = ngrok url
then go e.g. to https://e68c72dd903a.ngrok-free.app/info/welcome
now we can test the registration flow
now put your ngrok URL in cfg/dev.toml
to start in development mode do start_server_debug.sh
python tips
import pudb; pudb.set_trace()