commit dfe0ea6ac38ab90fbdd4892d161331b5750adbc1 Author: Julius Neumann Date: Sat Apr 25 20:28:13 2026 +0200 chore: initialize ml_for_robotics repository diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..79ce74a --- /dev/null +++ b/.gitignore @@ -0,0 +1,25 @@ +.venv/ +__pycache__/ +*.py[cod] +*.so +.pytest_cache/ +.mypy_cache/ +.ruff_cache/ +.ipynb_checkpoints/ +.DS_Store +.idea/ +.vscode/ +build/ +dist/ +*.egg-info/ +wandb/ +runs/ +checkpoints/ +artifacts/ +outputs/ +data/ +*.pt +*.pth +*.ckpt +*.onnx +*.log diff --git a/README.md b/README.md new file mode 100644 index 0000000..cbe9582 --- /dev/null +++ b/README.md @@ -0,0 +1,31 @@ +# ml_for_robotics + +Arbeitsbereich für eigene Notizen, Experimente, Material und kleine Artefakte rund um ML für Robotik. + +## Ziel + +Dieses Projekt sammelt: + +- Vorlesungsnotizen +- eigene Recherche +- Experimente und Prototypen +- referenzierbares Material für spätere Ausarbeitung + +## Status + +Noch keine feste Struktur. Wir bauen sie schrittweise auf, sobald klar ist, welche Themen und Artefakte hier rein sollen. + +## Schnellstart fuer Vast.ai SSH + +Das Repository ist absichtlich minimal gehalten, damit es sich in einer SSH-basierten GPU-Session schnell aktivieren laesst. + +1. Repository klonen oder in den Zielordner kopieren. +2. `./scripts/bootstrap.sh` ausfuehren. +3. Mit `. .venv/bin/activate` die virtuelle Umgebung aktivieren. +4. Eigene Abhaengigkeiten in `requirements.txt` oder spaeter in `pyproject.toml` ergaenzen. + +## Layout + +- `src/ml_for_robotics/` fuer Python-Code +- `scripts/` fuer Setup-Hilfen +- `requirements.txt` fuer optionale Laufzeit-Abhaengigkeiten diff --git a/pyproject.toml b/pyproject.toml new file mode 100644 index 0000000..b1247c5 --- /dev/null +++ b/pyproject.toml @@ -0,0 +1,16 @@ +[build-system] +requires = ["setuptools>=68", "wheel"] +build-backend = "setuptools.build_meta" + +[project] +name = "ml_for_robotics" +version = "0.1.0" +description = "Workspace for ML for robotics experiments" +readme = "README.md" +requires-python = ">=3.10" + +[tool.setuptools] +package-dir = {"" = "src"} + +[tool.setuptools.packages.find] +where = ["src"] diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000..e49b2cb --- /dev/null +++ b/requirements.txt @@ -0,0 +1 @@ +# Add runtime dependencies here when the project starts using them. diff --git a/scripts/bootstrap.sh b/scripts/bootstrap.sh new file mode 100755 index 0000000..1180496 --- /dev/null +++ b/scripts/bootstrap.sh @@ -0,0 +1,7 @@ +#!/usr/bin/env bash +set -euo pipefail + +python3 -m venv .venv +. .venv/bin/activate +python -m pip install --upgrade pip setuptools wheel +python -m pip install -e . diff --git a/src/ml_for_robotics/__init__.py b/src/ml_for_robotics/__init__.py new file mode 100644 index 0000000..9446913 --- /dev/null +++ b/src/ml_for_robotics/__init__.py @@ -0,0 +1,5 @@ +"""ml_for_robotics package.""" + +__all__ = ["__version__"] + +__version__ = "0.1.0"