This directory contains Jupyter notebooks for testing the AWS infrastructure.
You requested to use pyenv and uv. Here is an analysis of this choice:
- Speed:
uvis an extremely fast Python package installer and resolver, written in Rust. It is significantly faster thanpipandpoetry. - Isolation:
pyenvensures that the project uses a specific Python version, independent of the system's Python. This prevents version conflicts. - Modern Workflow: This combination represents a modern, efficient Python development workflow.
- Tool Availability: Requires both tools to be installed (which we verified you have).
- Kernel Registration: For Jupyter to "see" the virtual environment, it must be registered as a kernel. The
setup.shscript handles this.
-
Configure Environment Variables: Copy
.env.exampleto.envand fill in your AWS details.cp .env.example .env
-
Run Setup Script: This script will use
pyenvto set the local Python version, create a virtual environment withuv, install dependencies, and register the Jupyter kernel.chmod +x setup.sh ./setup.sh
-
Run the Notebook: Open
infrastructure_test.ipynbin VS Code or Jupyter Lab. Ensure the kernel selected isaws-infra-test. -
Run Vector Search Test: Open
s3_vector_search.ipynbto test vector generation and search capabilities.