diff --git a/.devcontainer/Dockerfile b/.devcontainer/Dockerfile
new file mode 100644
index 00000000..763c9a57
--- /dev/null
+++ b/.devcontainer/Dockerfile
@@ -0,0 +1,17 @@
+# Base image with Python 3.12 slim
+FROM mcr.microsoft.com/devcontainers/python:3.12-bullseye
+
+# Clean apt cache and reduce layers
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends \
+        git curl wget build-essential && \
+    apt-get clean && rm -rf /var/lib/apt/lists/*
+
+# Optional: remove unwanted preinstalled Python packages to save space
+RUN pip freeze | xargs pip uninstall -y || true
+
+# Create workspace directory
+WORKDIR /workspace
+
+# Set default shell
+SHELL ["/bin/bash", "-c"]
diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
new file mode 100644
index 00000000..760d87aa
--- /dev/null
+++ b/.devcontainer/devcontainer.json
@@ -0,0 +1,24 @@
+{
+  "name": "Python Codespaces Starter",
+  "dockerFile": "Dockerfile",
+  "context": "..",
+  "features": {
+    "ghcr.io/devcontainers/features/python:1": {
+      "version": "3.12" 
+    }
+  },
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "ms-pyright.pyright",
+        "ms-python.python"
+      ],
+      "settings": {
+        "python.analysis.typeCheckingMode": "basic",
+        "python.languageServer": "Pylance"
+      }
+    }
+  },
+  "postCreateCommand": "bash .devcontainer/setup.sh",
+  "remoteUser": "codespaces"
+}
diff --git a/.devcontainer/setup.sh b/.devcontainer/setup.sh
new file mode 100644
index 00000000..230d8346
--- /dev/null
+++ b/.devcontainer/setup.sh
@@ -0,0 +1,15 @@
+#!/bin/bash
+# Ensure script exits on error
+set -e
+
+echo "=== Cleaning Python caches and pip cache ==="
+rm -rf ~/.cache/pip
+rm -rf ~/.cache/pypoetry
+rm -rf ~/.local/share/virtualenvs
+
+echo "=== Installing project dependencies ==="
+if [ -f /workspaces/requirements.txt ]; then
+    pip install --no-cache-dir -r /workspaces/requirements.txt
+fi
+
+echo "=== Environment ready ==="
diff --git a/.gitignore b/.gitignore
index 45092090..fb281b40 100644
--- a/.gitignore
+++ b/.gitignore
@@ -75,3 +75,12 @@ htmlcov/
 .tox/
 .nox/
 .hypothesis/
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.env
+.venv/
+dist/
+build/
+*.egg-info/
diff --git a/data/.gitkeep b/data/.gitkeep
new file mode 100644
index 00000000..8b137891
--- /dev/null
+++ b/data/.gitkeep
@@ -0,0 +1 @@
+
diff --git a/data/usr/.gitkeep b/data/usr/.gitkeep
new file mode 100644
index 00000000..8b137891
--- /dev/null
+++ b/data/usr/.gitkeep
@@ -0,0 +1 @@
+
diff --git a/data/usr/agents/.gitkeep b/data/usr/agents/.gitkeep
new file mode 100644
index 00000000..8b137891
--- /dev/null
+++ b/data/usr/agents/.gitkeep
@@ -0,0 +1 @@
+
diff --git a/data/usr/knowledge/.gitkeep b/data/usr/knowledge/.gitkeep
new file mode 100644
index 00000000..8b137891
--- /dev/null
+++ b/data/usr/knowledge/.gitkeep
@@ -0,0 +1 @@
+
diff --git a/data/usr/knowledge/main/.gitkeep b/data/usr/knowledge/main/.gitkeep
new file mode 100644
index 00000000..8b137891
--- /dev/null
+++ b/data/usr/knowledge/main/.gitkeep
@@ -0,0 +1 @@
+
diff --git a/data/usr/knowledge/solutions/.gitkeep b/data/usr/knowledge/solutions/.gitkeep
new file mode 100644
index 00000000..8b137891
--- /dev/null
+++ b/data/usr/knowledge/solutions/.gitkeep
@@ -0,0 +1 @@
+
diff --git a/data/usr/plugins/.gitkeep b/data/usr/plugins/.gitkeep
new file mode 100644
index 00000000..8b137891
--- /dev/null
+++ b/data/usr/plugins/.gitkeep
@@ -0,0 +1 @@
+
diff --git a/data/usr/skills/.gitkeep b/data/usr/skills/.gitkeep
new file mode 100644
index 00000000..8b137891
--- /dev/null
+++ b/data/usr/skills/.gitkeep
@@ -0,0 +1 @@
+
diff --git a/data/usr/workdir/.gitkeep b/data/usr/workdir/.gitkeep
new file mode 100644
index 00000000..8b137891
--- /dev/null
+++ b/data/usr/workdir/.gitkeep
@@ -0,0 +1 @@
+
diff --git a/logs/.gitkeep b/logs/.gitkeep
new file mode 100644
index 00000000..8b137891
--- /dev/null
+++ b/logs/.gitkeep
@@ -0,0 +1 @@
+