Skip to content

About

Small scale experiments, tooling, learning logs, and anything in between.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

15 Commits

Folders and files

Repository files navigation

╔══════════════════════════════════════════════════════════════════════════════════════════╗
β•‘                                                                                          β•‘
β•‘   β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ•—β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•— β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—     β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•— β–ˆβ–ˆβ•—   β–ˆβ–ˆβ•—β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—     β•‘
β•‘   β–ˆβ–ˆβ•”β•β•β•β•β•β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•—β–ˆβ–ˆβ•”β•β•β•β•β•    β–ˆβ–ˆβ•”β•β•β•β–ˆβ–ˆβ•—β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•”β•β•β•β•β•β–ˆβ–ˆβ•”β•β•β•β•β•β•šβ•β•β–ˆβ–ˆβ•”β•β•β•β–ˆβ–ˆβ•”β•β•β•β•β•     β•‘
β•‘   β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘  β–ˆβ–ˆβ•‘β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—      β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—  β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—   β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—     β•‘
β•‘   β•šβ•β•β•β•β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘  β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•”β•β•β•      β–ˆβ–ˆβ•‘β–„β–„ β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•”β•β•β•  β•šβ•β•β•β•β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘   β•šβ•β•β•β•β–ˆβ–ˆβ•‘     β•‘
β•‘   β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•”β•β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—    β•šβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•”β•β•šβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•”β•β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•‘     β•‘
β•‘   β•šβ•β•β•β•β•β•β•β•šβ•β•β•šβ•β•β•β•β•β• β•šβ•β•β•β•β•β•β•     β•šβ•β•β–€β–€β•β•  β•šβ•β•β•β•β•β• β•šβ•β•β•β•β•β•β•β•šβ•β•β•β•β•β•β•   β•šβ•β•   β•šβ•β•β•β•β•β•β•     β•‘
β•‘                                                                                          β•‘
β•‘              Experimental Computing Laboratory & Digital Atelier                β•‘
β•‘                                                                                          β•‘
β•šβ•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•

Status License Python Focus Architecture

Typing SVG



πŸ§ͺ Experiments
4 Active
πŸ€– Agents
3 Deployed
🧠 Models
7 Trained
⚑ Commits
13+

πŸ“‹ Table of Contents


🧭 Philosophy

"The side quest is not a distraction from the main story β€” it is where the character levels up."

This repository serves as a computational laboratory for small-scale experiments, tooling prototypes, learning artifacts, and exploratory systems. It operates under the principle that serendipitous discovery requires structured chaos. Every directory represents a hypothesis; every commit, an experiment concluded.

Core Tenets

Tenet Description
🎯 Intentional Scope Each experiment is bounded, measurable, and independently reproducible
πŸ“ Narrative Code Documentation is not an afterthought β€” it is the primary artifact
πŸ”„ Composability Modules are designed to be extracted, repurposed, or abandoned without collateral damage
🌊 Fluid Architecture Directories evolve; what begins as 03-generative-ai may seed a standalone repository

πŸ—ΊοΈ Repository Cartography

%%{init: {'theme': 'dark', 'themeVariables': { 'primaryColor': '#58A6FF', 'edgeLabelBackground':'#0d1117', 'tertiaryColor': '#161b22'}}}%%
mindmap
  root((Side Quests))
    AI Engineering
      ::icon(🧠)
      Agent orchestration
      Prompt engineering
      Tooling frameworks
    Generative AI
      ::icon(🎨)
      Diffusion models
      Text-to-X pipelines
      Synthetic data generation
    Machine Learning
      ::icon(πŸ“Š)
      Classical algorithms
      Feature engineering
      Model evaluation suites
    Deep Learning
      ::icon(πŸ”¬)
      Image caption classifiers
      Neural architectures
      Transfer learning experiments
Loading

Directory Structure

side-quests/
β”‚
β”œβ”€β”€ πŸ“ 01-ai-engineering/
β”‚   └── Agent systems, prompt engineering frameworks, and LLM tooling
β”‚
β”œβ”€β”€ πŸ“ 03-generative-ai/
β”‚   └── Generative models, synthetic media pipelines, and creative AI
β”‚
β”œβ”€β”€ πŸ“ 04-machine-learning/
β”‚   └── Classical ML experiments, feature engineering, and model suites
β”‚
β”œβ”€β”€ πŸ“ 07-deep-learning/
β”‚   └── Neural architectures, computer vision, and deep learning research
β”‚   └── πŸ“ image-caption-classifier/
β”‚       └── Vision-language model for automated image understanding
β”‚
└── πŸ“„ README.md
    └── You are here. Meta-documentation for the repository itself.

Note on Numeration: Directory prefixes (01-, 03-, etc.) reflect chronological exploration phases, not priority. Gaps exist where experiments were concluded, extracted, or archived.


πŸ› οΈ Technology Stack

Python
Python
PyTorch
PyTorch
TensorFlow
TensorFlow
Jupyter
Jupyter
Docker
Docker
Git
Git
NumPy
NumPy
Pandas
Pandas
OpenCV
OpenCV
FastAPI
FastAPI
Linux
Linux
VS Code
VS Code

πŸš€ Getting Started

Prerequisites

  • Python β‰₯ 3.10
  • Git β‰₯ 2.35
  • Poetry or pip (dependency management)
  • CUDA β‰₯ 11.8 (for GPU-accelerated experiments)

Quick Start

# Clone the repository
git clone https://github.com/pseudobarbie/side-quests.git
cd side-quests

# Navigate to an experiment (example: image-caption-classifier)
cd 07-deep-learning/image-caption-classifier

# Install dependencies
pip install -r requirements.txt
# or
poetry install

# Run the experiment
python main.py

Environment Isolation

Each experiment directory is self-contained. We recommend using Conda or venv per project to prevent dependency entropy:

python -m venv .venv
source .venv/bin/activate  # Linux/macOS
# .venv\Scripts\activate  # Windows

πŸ“š Project Index

🧠 01-ai-engineering β€” Agent Systems & LLM Tooling
Experiment Status Description
travel-agent-planner βœ… Complete LLM-powered itinerary generation with constraint satisfaction
prompt-chaining 🚧 WIP Multi-stage prompt decomposition for complex reasoning
tool-use-framework 🚧 WIP ReAct-pattern agent with extensible tool registry
🎨 03-generative-ai β€” Synthetic Media & Creative Models
Experiment Status Description
text-to-image-pipeline 🚧 WIP Fine-tuned diffusion model for domain-specific generation
synthetic-data-generator 🚧 WIP Tabular and text synthetic data for privacy-preserving ML
πŸ“Š 04-machine-learning β€” Classical ML & Analytics
Experiment Status Description
ensemble-methods 🚧 WIP Comparative analysis of boosting, bagging, and stacking
feature-engineering-suite 🚧 WIP Automated feature selection and transformation pipelines
πŸ”¬ 07-deep-learning β€” Neural Architectures & CV
Experiment Status Description
image-caption-classifier βœ… Complete Vision-language model combining CNN encoders with LSTM/Transformer decoders
transfer-learning-benchmark 🚧 WIP Systematic evaluation of fine-tuning strategies across architectures

βš™οΈ Development Workflow

%%{init: {'theme': 'dark'}}%%
graph LR
    A[πŸ’‘ Hypothesis] --> B[πŸ“ Design Doc]
    B --> C[πŸ”¨ Prototype]
    C --> D{πŸ§ͺ Evaluation}
    D -->|Promising| E[πŸ“¦ Extract Module]
    D -->|Inconclusive| F[πŸ—ƒοΈ Archive]
    D -->|Needs Iteration| C
    E --> G[🌱 New Repository]
    F --> H[πŸ“š Knowledge Base]
    style A fill:#58A6FF,stroke:#58A6FF,color:#fff
    style E fill:#238636,stroke:#238636,color:#fff
    style F fill:#8B949E,stroke:#8B949E,color:#fff
Loading

Commit Convention

We follow a semantic commit structure to maintain narrative coherence across experiments:

feat(01-ai): add ReAct agent scaffolding
fix(07-dl): resolve gradient accumulation in caption classifier
chore(repo): update root README with project index
docs(04-ml): document ensemble method hyperparameters

🀝 Contributing

While this is primarily a personal research repository, constructive contributions are welcome under the following guidelines:

  1. Fork the repository and create a feature branch (git checkout -b experiment/amazing-idea)
  2. Document your hypothesis in the experiment's README.md
  3. Isolate dependencies β€” do not pollute the root environment
  4. Submit a Pull Request with a clear description of the experiment's objective and findings

⚠️ Note: Experiments may be archived or removed if they are concluded, extracted, or superseded. This is by design.


πŸ“œ License & Attribution

MIT License

Copyright (c) 2026 pseudobarbie

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

GitHub

Activity Graph



"The most exciting phrase to hear in science, the one that heralds new discoveries, is not 'Eureka!' but 'That's funny...'"

β€” Isaac Asimov


GitHub Contribution Snake

About

Small scale experiments, tooling, learning logs, and anything in between.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors