ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β β β ββββββββββββββββββ ββββββββ βββββββ βββ ββββββββββββββββββββββββββββββββββββ β β βββββββββββββββββββββββββββ ββββββββββββ ββββββββββββββββββββββββββββββββββββ β β ββββββββββββββ βββββββββ βββ ββββββ βββββββββ ββββββββ βββ ββββββββ β β ββββββββββββββ βββββββββ βββββ ββββββ βββββββββ ββββββββ βββ ββββββββ β β βββββββββββββββββββββββββββ ββββββββββββββββββββββββββββββββββ βββ ββββββββ β β ββββββββββββββββββ ββββββββ βββββββ βββββββ ββββββββββββββββ βββ ββββββββ β β β β Experimental Computing Laboratory & Digital Atelier β β β ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
π§ͺ Experiments4 Active |
π€ Agents3 Deployed |
π§ Models7 Trained |
β‘ Commits13+ |
- Philosophy
- Repository Cartography
- Technology Stack
- Getting Started
- Project Index
- Development Workflow
- Contributing
- License & Attribution
"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.
| 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 |
%%{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
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.
- Python β₯ 3.10
- Git β₯ 2.35
- Poetry or pip (dependency management)
- CUDA β₯ 11.8 (for GPU-accelerated experiments)
# 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.pyEach 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π§ 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 |
%%{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
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
While this is primarily a personal research repository, constructive contributions are welcome under the following guidelines:
- Fork the repository and create a feature branch (
git checkout -b experiment/amazing-idea) - Document your hypothesis in the experiment's
README.md - Isolate dependencies β do not pollute the root environment
- 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.
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.