| --- |
| title: Andrej Janchevski - PhD Research |
| emoji: 📚 |
| colorFrom: green |
| colorTo: gray |
| sdk: docker |
| app_port: 7860 |
| pinned: false |
| license: mit |
| --- |
| |
| # Andrej Janchevski — PhD Research |
|
|
| Live demos for the PhD thesis _Scalable Methods for Knowledge Graph Reasoning and Generation_ (Andrej Janchevski, EPFL, 2025). The thesis is mirrored at [infoscience.epfl.ch](https://infoscience.epfl.ch/entities/publication/87acf391-feef-43a0-b665-7f2f0bc70b2c); a CV is rendered at `/cv` from `docs/cvAndrejJanchevski.pdf`. |
|
|
| The site is a single Django + Vue Docker container. The Django backend serves a stateless REST API at `/api/v1/*` and WhiteNoise serves the built Vue SPA on every other path — same origin, no CORS in production. Deployment target: Hugging Face [Space](docs/glossary.md#hf-space) `Bani57/website` → <https://bani57-website.hf.space>. |
|
|
| ## What's in the demos |
|
|
| | Demo | Thesis | What it does | |
| |---|---|---| |
| | [COINs](docs/glossary.md#coins) — KG reasoning | §3.1 | Link prediction and multi-hop / intersection query answering on FB15k-237, WN18RR and NELL-995, with six embedding algorithms (TransE, DistMult, ComplEx, RotatE, Q2B, KBGAT). | |
| | [MultiProxAn](docs/glossary.md#multiproxan) — graph generation | §4.3 | Discrete denoising diffusion for molecular and synthetic graphs, with an outer Gibbs loop (MultiProx) that round-trips through `/continue` for live previews. | |
| | KG anomaly correction | §4.4 | Diffusion-based denoising of knowledge-graph subgraphs with a per-frame KG log-likelihood metric from the frozen COINs link ranker. | |
|
|
| ## Layout |
|
|
| ``` |
| . |
| ├── Dockerfile, environment.yml, docker-compose.yml, entrypoint.sh, .dockerignore |
| ├── README.md # this file (also the HF Space landing card) |
| ├── src/backend/ # Django REST API |
| ├── src/frontend/ # Vue 3 SPA |
| ├── src/research/ # research code, imported via sys.path |
| ├── scripts/ # one-off helpers (checkpoint upload, motif export) |
| ├── docs/ # technical documentation (start at docs/README.md) |
| └── plans/ # implementation plans for major work |
| ``` |
|
|
| ## Quick start |
|
|
| ### Option A — Docker (production-equivalent) |
|
|
| ```bash |
| cp .env.example .env |
| python -c "import secrets; print('DJANGO_SECRET_KEY=' + secrets.token_urlsafe(50))" >> .env |
| docker compose up --build |
| ``` |
|
|
| `http://localhost:7860`. First build is ~20–30 minutes (mamba env solve, GPU torch wheels, frontend bundle, ~5.4 GB checkpoint pull from HF Hub). Subsequent runs reuse layer cache and the `checkpoints` named volume. |
|
|
| ### Option B — local Python + Vite (dev) |
|
|
| ```bash |
| mamba env create -n website_c -f environment.yml |
| mamba activate website_c |
| pip install --extra-index-url https://download.pytorch.org/whl/cu118 -r src/backend/requirements.txt |
| ( cd src/backend && DJANGO_DEBUG=True python manage.py runserver 8000 ) & |
| ( cd src/frontend && npm install && npm run dev ) |
| ``` |
|
|
| Backend on `:8000`, Vite on `:5173`. The dev frontend env file points the SPA at the local backend. |
|
|
| Full instructions: [`docs/guides/local-development.md`](docs/guides/local-development.md). |
|
|
| ## Documentation |
|
|
| The [`docs/`](docs/) directory holds the full documentation set, organized by [Diataxis](https://diataxis.fr) document type: |
|
|
| - [`docs/README.md`](docs/README.md) — index and routing. |
| - [`docs/glossary.md`](docs/glossary.md) — domain terms (COINs, MultiProxAn, query structures, SSE, inference lock, …). |
| - [`docs/explanation/`](docs/explanation/) — architecture, research methods, inference lifecycle. |
| - [`docs/reference/`](docs/reference/) — API, SSE protocol, backend services, frontend modules. |
| - [`docs/guides/`](docs/guides/) — local development, deployment. |
| - [`docs/api.yaml`](docs/api.yaml) — OpenAPI 3.0.3 source of truth for the REST API. |
| - [`docs/postman/`](docs/postman/) — Postman collection and environment for hand-testing. |
|
|
| The Django backend has its own README at [`src/backend/README.md`](src/backend/README.md) and the Vue SPA at [`src/frontend/README.md`](src/frontend/README.md). Both link back to `docs/` for the deeper material. |
|
|
| ## Deploying |
|
|
| `git push hf master:main` to the Space remote. See [`docs/guides/deploy.md`](docs/guides/deploy.md) for the full procedure (Space secrets, checkpoint refresh on HF Hub, rollback, persistent storage option). |
|
|
| ## License |
|
|
| MIT for the website code. The PhD thesis and individual research methods retain their original publication terms; see the thesis PDF. |
|
|
