| 🚀 Project | 🛠️ Type | 🚦 Status | 📋 Master Preparation Steps | 🔗 System Path |
|---|---|---|---|---|
| Dev Knowledgebase | Hugo | Local development stack running with a local GitHub API shim and Sveltia CMS admin portal. | • Configure and start hugo-knowledgebase.service, local-github-api.service, and hugo-kb-https-proxy.service systemd units. • Ensure valid SSL certificates (kb.key, kb.crt) are deployed in /home/dev/certs/. • Update baseURL in hugo.toml to the production domain. • Configure Sveltia CMS API endpoints in static/admin/config.yml to match production URLs. • Secure external ingress to internal ports 55888 and 8082, and protect the /admin path. | [Dev Knowledgebase](vscode://fileDev Knowledgebase) |
| GOMA | Hugo | Configured for development with local layouts, shortcodes, and demo content, integrating with GIMA on port 55220 | • Compile Go binary using Go 1.24+ with CGO_ENABLED=1 and tags ‘extended,withdeploy’ • Replace development baseURL in hugo.toml with production domain • Route standard production ports to the server and disable LiveReload • Bundle and place required GIMA React dependencies in the static directory or serve via CDN • Configure release credentials in hugoreleaser.env and verify hugoreleaser.yaml configuration • Optimize Dockerfile builds and set HUGO_BUILD_TAGS for production deployment | GOMA |
| Hugo Knowledgebase Archetypes | Hugo | Single basic default archetype configured; lacks taxonomies and specialized templates | • Define specialized archetypes for guides, cheatsheets, and reference • Add default taxonomies (tags, categories) to default archetype • Align archetypes with Sveltia CMS config • Standardize on TOML front matter formatting | [Hugo Knowledgebase Archetypes](vscode://fileHugo Knowledgebase Archetypes) |
| hugdown | Hugo | 95% complete - production ready | • Set up Nginx reverse proxy configuration • Add automated E2E tests (Playwright) • Implement performance monitoring and error tracking • Conduct security audit and configure CSP headers • Set up health check endpoints • Document deployment rollback procedures | hugdown |
| hugmark | Hugo | Partially complete (70%) with daisyUI styling and PDF generation functional but requires security, determinism, and repository cleanup improvements. | • Restrict /generate-pdf-url endpoint to local domains to prevent SSRF vulnerabilities. • Inline compiled CSS into PDF HTML payload to eliminate external CDN dependencies and ensure rendering determinism. • Configure CORS on the PDF server to accept requests only from the static site’s origin. • Remove duplicate layouts/index.html, unify developer documentation, and gitignore build/test artifacts. • Migrate text editing to a block editor like EditorJS and automate A4 page-overflow flow control. • Establish automated E2E smoke tests using Playwright or Puppeteer. | hugmark |
| hugo-book | Hugo | Clean theme directory ready for integration | • Verify Hugo Extended version 0.128.0+ is installed • Configure theme parameters in hugo.toml • Run hugo —minify to build production assets | hugo-book |
| hugo-knowledgebase | Hugo | Development wiki using Sveltia CMS and local GitHub API shim. Contains stale generated assets, test artifacts, unauthenticated API endpoints, and path traversal security vulnerabilities. | • Clean the public/ and resources/ directories before builds (or use —cleanDestinationDir) to delete stale and test files. • Implement path traversal verification in local-github-api.mjs endpoints to enforce files stay within REPO_ROOT. • Add API token authentication to local-github-api.mjs and configure config.yml accordingly. • Bind internal services (Hugo on 55888 and Local API on 8082) to 127.0.0.1 instead of 0.0.0.0. • Transition TLS termination and reverse proxying from https-proxy.mjs to Nginx or Caddy. • Replace the self-signed certificate for 0rk.de with a trusted CA (e.g., Let’s Encrypt) certificate. • Disable draft rendering (-D) and disableFastRender in the production Hugo service context. | hugo-knowledgebase |
| hugo-knowledgebase | Hugo | All services (Hugo server, GitHub API shim, and HTTPS proxy) are active and running as systemd services with configured TLS. | • Secure/restrict access to the local GitHub API shim and HTTPS proxy. • Implement proper user authentication/authorization for Sveltia CMS. • Replace self-signed TLS certificates with production CA-signed certificates. • Ensure robust backup and Git synchronization strategies for content changes. • Remove Hugo draft (-D) and fast render flags from production execution. • Configure the production hostname and base URL in hugo.toml. • Set up monitoring and log rotation for the three systemd services. | hugo-knowledgebase |
| knowledgebase | Hugo | Hugo site with local GitHub API shim and HTTPS proxy. Systemd unit files present but not installed. | • Configure git safe directory configuration for /home/dev/knowledgebase • Install and enable the systemd service files in /etc/systemd/system/ • Verify SSL/TLS certificate validity in /home/dev/certs/ • Adjust Hugo server parameters in hugo-knowledgebase.service for production • Expose port 55889 securely through firewall or reverse proxy | knowledgebase |
| knowledgebase | Hugo | The resources directory contains Hugo’s generated SCSS caches and assets (_gen/). The parent directory is a Hugo static site utilizing Sveltia CMS with a custom Node.js GitHub API emulation shim and HTTPS proxy. Standard package files (package.json) and requirements files are absent as both Node.js scripts rely purely on native Node.js core modules. Systemd service files are configured for daemonized deployment. | • Run ‘hugo’ to compile and output optimized production static assets in the public/ directory instead of using the local development server. • Verify and configure systemd service units (hugo-knowledgebase.service, local-github-api.service, and hugo-kb-https-proxy.service) to start automatically on system boot. • Restrict file permissions on the SSL certificate and private key files in ‘/home/dev/certs/’ (e.g., chmod 600 kb.key) to ensure they are only readable by the owner (dev user). • Configure firewall rules or an external reverse proxy (like Nginx) to properly route public HTTP/HTTPS traffic to the application port 55889. • Verify Node.js is installed on the host system to execute the GitHub API shim and HTTPS proxy. | knowledgebase |
| hugdown | Hugo, nodejs | Core implementation 95% complete; development logs present; optimization and production hosting configuration pending | • Configure Tailwind CSS purging to reduce CSS bundle size (currently 5.5MB) • Configure Nginx reverse proxy for unified routing (/api/ to GOMA, /poster/ to GIMA) • Create systemd service files or PM2 configurations for production daemonization • Automate SSL/TLS certificate setup • Create Docker Compose configuration for containerized deployment • Implement Playwright E2E automated test suite | hugdown |
| WorkWorld | Nodejs | Partially configured; core Node.js backend/tests present, deployment configurations and domain/port setups documented but pending | • Configure Domains and DNS A/AAAA records for WorkAdventure, LiveKit, and Coturn. • Configure firewalls per host exposing only minimal required ports. • Install and configure Coturn with static auth secret, external IP, and TLS certificates. • Deploy LiveKit SFU configured with appropriate UDP ranges and API keys. • Fetch WorkAdventure production docker-compose and configure .env with real secrets/endpoints. • Harden environment by routing gRPC and LiveKit signaling over port 443. • Run verification tests (P2P, LiveKit, strict NAT, and Playwright test suite). | WorkWorld |
| ai-town | Nodejs | development (build fails due to type/config errors) | • Fix TypeScript compile errors including duplicate imports of ‘internal’ in convex/agent/embeddingsCache.ts, convex/agent/memory.ts, convex/aiTown/game.ts, and convex/init.ts. • Resolve file permission constraints on tsconfig.tsbuildinfo. • Configure required environment variables including Convex URL, admin key, LLM provider config, and Replicate API token. • Fix ESLint configuration parser issue in .eslintrc.js. • Run production build via npm run build and deploy. | ai-town |
| chatgpt-md & chatgpt-md-templates | Nodejs | Contains an Obsidian plugin written in TypeScript with esbuild build config, plus companion templates. Contains node_modules but has build-time file permission errors. | • Fix file permissions to allow writing compile output (main.js) • Resolve access/permission issues with /home/dev/.npmrc • Integrate a unit testing framework (e.g. Vitest/Jest) • Write test suites for core ServiceLocator, FrontmatterService, and parser logic • Deduplicate package locks (either package-lock.json or yarn.lock) • Set up continuous integration (CI) pipeline for tests, linting, and building | [chatgpt-md & chatgpt-md-templates](vscode://filechatgpt-md & chatgpt-md-templates) |
| daisystory | Nodejs | Broken due to Tailwind CSS v4 and DaisyUI v5 integration errors, and directory permission limits. | • Install @tailwindcss/postcss (or @tailwindcss/vite) and update PostCSS configuration. • Update src/index.css to use Tailwind CSS v4 imports (@import “tailwindcss”; and @import “daisyui”;). • Remove deprecated tailwind.config.js and clean up PostCSS v3 plugins. • Refactor stories/theme/ThemeDesigner.stories.js to map legacy CSS variables (—p, —s, —b1, etc.) to DaisyUI v5 variable names (—color-primary, —color-secondary, —color-base-100, etc.) and drop deprecated focus variables. • Update .storybook/preview.js decorator to read from context.globals.theme to enable live updates on Storybook toolbar theme changes. • Ensure build user has write permissions to create storybook-static distribution directory, then build and host compiled assets. | daisystory |
| daisyui | Nodejs | A Bun-based monorepo for daisyUI 5 where the root package.json has been modified to a SvelteKit app (daisyui-svelte-studio) and Svelte/Vite configs are present at the root, but the SvelteKit project lacks a ‘src’ directory, leaving the monorepo and studio in an incomplete/broken state. | • Revert root package.json changes to restore the original daisyui-monorepo Bun workspace configuration. • Move the SvelteKit configurations (svelte.config.js, vite.config.js, tailwind.config.js, postcss.config.js) and daisyui-svelte-studio directory to a dedicated package inside ‘packages/’ if the studio is a desired sub-project. • Ensure Bun (v1.2.8 or newer) is installed as the package manager as specified in the original package.json. • Run ‘bun install’ at the root to install workspace-wide dependencies. • Add SvelteKit application source code (src/ folder) under the appropriate studio package directory. • Run ‘bun run build’ inside packages/daisyui to compile the core daisyUI styles and components. • Verify build integrity of the documentation site by running ‘bun run build:docs’ to ensure the static docs compile without errors. | daisyui |
| funday | Nodejs | Needs preparation steps for production deployment | • Remove development test files (test-games-api.html, test-lobby.js, test-web-lobby.html) • Secure environment variables and remove exposed API keys from .env • Generalize config to remove hardcoded IP/domains (173.212.213.72, 0rk.de) • Change client SvelteKit adapter from adapter-auto to adapter-node • Set up a reverse proxy (e.g. Nginx, Caddy) for SSL/TLS and standard ports routing • Implement process monitoring via PM2 or systemd instead of raw nohup • Run the build and start commands via start-funday.sh | funday |
| funday-platform | Nodejs | Operational but fails to load Pung game module due to runtime TypeScript error | • Fix TypeScript type error in server/gameModules/pung/main.ts at line 500 • Resolve the stuck countdown runtime logic bug in Pung game module • Update dependencies to resolve security vulnerabilities | funday-platform |
| markdown-to-image | Nodejs | development (unbuilt/permissions restricted) | • Fix permissions/ownership of project files and configure Git safe directory • Standardize on a single package manager and remove duplicate lockfiles • Configure monorepo workspace to link Next.js example locally • Integrate automated unit tests using Vitest or Jest • Enable dynamic port binding and resolve EACCES write issues | markdown-to-image |
| AgentLaboratory | Python | development | • Remove import tensorflow as tf from common_imports.py to fix immediate ModuleNotFoundError blocker.• Restore or create the missing HTML templates (index.html, upload.html, search.html, view.html) under a templates directory for the Flask app.• Fix typo flask_sqlalchemysentence-transformers in requirements.txt to split into separate valid packages.• Remove and rotate hardcoded OpenRouter API keys from YAML configs (e.g. CREATIVE_genre_mashup.yaml, MATH_agentlab.yaml) and the .env file, and load them via environment variables.• Fix inconsistent configuration parsing keys between ai_lab_repo.py (copilot_mode, api-key) and config YAML files (copilot-mode, OpenRouter keys).• Replace hardcoded Flask SECRET_KEY with secure environment variable loading.• Disable automatic database deletion on startup in app.py and implement database migrations (e.g., Flask-Migrate / Alembic).• Upgrade Python virtual environment from 3.11.2 to 3.12 to match the README.md recommendation. • Configure a production WSGI server (like Gunicorn) instead of running the development Flask server in debug mode. • Implement python’s structured logging framework instead of print statements for production monitoring.• Set up a testing framework (pytest) with unit and integration tests. | AgentLaboratory |
| AudioFlux Showcase | Python | Inactive / Stopped (No active server processes on ports 7860, 7861, or 7863) | • Uncomment audioflux and librosa dependencies in requirements.txt to ensure clean, automated environment rebuilds. • Set up process supervisor orchestration (such as systemd or Docker Compose) to handle background execution and auto-restarts. • Implement a reverse proxy (e.g., Nginx or Caddy) for routing, SSL/TLS termination, and security hardening. • Refactor hardcoded network/port settings to retrieve configuration from environment variables. • Configure log rotation for log files under app/logs/ to prevent disk space exhaustion. • Establish an automated CI/CD pipeline to run the app/test_unified_dashboard.py test suite. | [AudioFlux Showcase](vscode://fileAudioFlux Showcase) |
| Langflow Workflows | Python | Active developmental Langflow instance with database, log history, and generated outputs | • Secure plaintext credentials and API keys in .env (move to secrets manager) • Clean up ~410MB of historical log files and implement log rotation • Remove generated markdown files (*.markdown) and clean up out/ directory • Migrate SQLite database to a production-grade database like PostgreSQL • Set up a production ASGI server and reverse proxy with SSL/TLS termination • Restrict .env file permissions (chmod 600) and remove _.env backup • Configure systemd service for automated startup and process monitoring | [Langflow Workflows](vscode://fileLangflow Workflows) |
| Learn Prompting Web Scraper and Knowledge Base | Python | Contains compiled markdown documentation and a virtual environment, but scraper scripts and configuration files are missing. | • Restore or implement the missing Python scraper/compiler scripts. • Standardize dependency management by creating a requirements.txt or pyproject.toml. • Recreate the Python virtual environment to fix absolute path shebang errors. • Implement validation tests (e.g., pytest and markdown-link-check) for link integrity and structure. • Add a root README.md file explaining project usage, architecture, and rebuild procedures. • Establish CI/CD pipeline for markdown formatting and validation. | [Learn Prompting Web Scraper and Knowledge Base](vscode://fileLearn Prompting Web Scraper and Knowledge Base) |
| ebay-sniper | Python | Headless Python eBay auction sniper with Playwright automation, SQLite database, and FastAPI service wrapper | • Install python dependencies from requirements.txt • Install Playwright browser binaries via playwright install • Configure environment variables from .env.example • Configure eBay credentials in config/config.yaml • Setup systemd service or Docker container for 24/7 runtime | ebay-sniper |
| flowjourney | Python | Development state with 8 failing tests out of 104 due to JobStatus enum mismatch. | • Fix test suite failures caused by JobStatus enum schema changes • Add authentication and authorization layers to the NiceGUI web interface • Configure production database migrations and schema versioning via Alembic • Set up production-ready environment configurations and logging handlers • Establish Dockerization and deployment orchestration patterns • Verify integration and rate-limiting with real MidJourney API endpoints • Set up Prometheus monitoring alerts and dashboard configurations | flowjourney |
| gradiomulti | Python | Development / Prototype (unconsolidated entrypoints, insecure database and file permissions, critical eval vulnerability) | • Restrict .env permissions to owner-only (chmod 600) and generate JWT_SECRET_KEY. • Relocate SQLite databases (users.db, sessions.db, performance_metrics.db) to a secure folder and restrict access. • Consolidate multiple entrypoints (simple_app.py, working_app.py, etc.) to establish a single production launch script. • Remediate arbitrary code execution risks (replace eval() usage in tool_calling.py’s calculate tool). • Upgrade vulnerable dependencies like pillow and re-lock requirements. | gradiomulti |
| groqgradio | Python | Partially configured with active port conflicts, hardcoded secrets, and conflicting dependency specifications | • Resolve port conflict in .env by setting GRADIO_SERVER_PORT_MAIN to 55441 (conflicts with app_streamlined.py port 55444). • Consolidate dependencies: pyproject.toml lists Gradio 4.x and Pydantic 2.x, while requirements.txt specifies older Gradio 3.x and Pydantic 1.x. • Remove hardcoded Groq and Langflow API keys from .env and load them securely from environment variables in production. • Deploy systemd services from the systemd/ directory using deploy-services.sh and verify they start correctly. • Configure a reverse proxy like Nginx or Caddy to route traffic from public ports to the internal Gradio services with SSL/TLS. • Clean up unused workspace files like app_minimal.py.bkp, app_langflow.py.bkp, and favicon.zip. | groqgradio |
| mdpdf | Python | evaluation | • Select primary PDF conversion engine • Install external system binaries (pandoc, wkhtmltopdf, cairo) • Consolidate python packages and dependency management • Create unified virtual environment • Integrate testing and linting pipelines | mdpdf |
| mediacollect | Python | In progress: migrating a legacy hybrid Bash/Python script collection with duplicate functionality into a structured, async-first Python package. | • Configure development environment tooling, including git, uv, ruff, black, and mypy. • Design and implement YAML-based configuration schema and settings management using Pydantic. • Establish structured JSON logging with correlation IDs and log rotation/retention. • Implement type-safe Pydantic data models for Channel, Video, Caption, and Session. • Build a unified CLI entry point using Click/Typer to replace the legacy Bash router. • Refactor the core scraping engine into an async-first Python class with adaptive rate limiting. • Secure credential storage by implementing an encrypted cookie manager module to replace plain-text files. • Implement subtitle format converters supporting async file operations. • Set up a comprehensive testing infrastructure using pytest with unit, integration, and E2E test suites. • Create CI/CD workflows for testing, vulnerability scanning, and automated packaging. | mediacollect |
| mixbox | Python | Workspace healthy with 213 tests passing, but needs documentation updates, dependency deprecation fixes, and CI integration. | • Address Carryover c1 (Operator-Role Boundaries) and c2 (Client Documentation) in docs/READMEs. • Migrate deprecated tool.uv.dev-dependencies to dependency-groups.dev. • Add automated CI pipelines for deploy/scripts/run-validation-gate.sh and pre-commit checks. • Integrate failure notifications (e.g., Slack/email webhook) for nightly systemd validation timer runs. • Establish log rotation for validation logs and clean up/evict stale entries in .audio_analysis_cache. | mixbox |
| mjgui | Python | Partially functional Midjourney NiceGUI front-end and FastAPI back-end; contains template configs, database files, and broken test configurations that need addressing before production readiness. | • Configure production-ready config.ini and .env from templates. • Fix conftest.py.BROKEN and ensure the pytest suite runs and passes successfully. • Resolve image download and generation task flow issues outlined in ONBOARDING.md. • Establish clean database migrations/initialization logic for aiosqlite/mjgui.db. • Restrict CORS origins in api_server.py and secure application secrets. • Establish logging rotation to avoid storage depletion. • Create containerized deployment descriptors (e.g. Dockerfile) or systemd unit definitions. | mjgui |
| mugen | Python | development | • Install system-level dependencies: ffmpeg, tesseract, and libsndfile. • Migrate older Python package pins (e.g., numpy1.22.2, librosa0.8.1) to versions compatible with Python 3.11+. • Set up a Python virtual environment (venv) for local deployment as conda is missing. • Bootstrap external test media from scherroman/mugen-media to enable test suite execution. • Containerize using Docker to bundle system binaries (FFmpeg, Tesseract OCR, libsndfile) for production deployment. • Introduce dependency locking (e.g., poetry.lock or requirements.txt with hashes) for repeatable builds. | mugen |
| mugen-webui | Python | Incomplete configuration: Tests are failing due to missing/ignored media assets; system dependencies are not packaged; web UI uses blocking calls in local dev mode. | • Restore/generate media test assets for pytest suite. • Document and containerize system dependencies (ffmpeg, libsndfile1-dev, tesseract-ocr). • Refactor webui.py to offload video generation to an asynchronous background task runner/queue. • Standardize platform-specific hardcoded paths (e.g. Windows separators) in webui.py. • Update launch settings in webui.py to support headless environments (inbrowser=False, server_name=‘0.0.0.0’). | mugen-webui |
| nicegui | Python | Python virtual environment path mismatch; frontend web dependencies are missing from nicegui/static. | • Recreate or update the Python virtual environment (demo_venv) to fix the invalid hardcoded path configuration. • Run `python3 npm.py .` to download and extract the external web dependencies defined in `npm.json` to the `nicegui/static` directory. • Install Python project dependencies and extras via Poetry or pip in the virtual environment. • Configure browser driver dependencies (Chrome/Selenium) and execute the test suite via `test_startup.sh` or `pytest`. • Build the production container using `release.dockerfile` or execute deployment using `deploy.sh` via Fly.io. | nicegui |
| py-ai | Python | Contains multiple independent Python AI packages and example applications without root coordination. | • Initialize a root-level Python workspace (e.g., using uv workspaces or Poetry) to manage dependencies. • Configure a root-level .env.example with required API keys (OpenAI, ElevenLabs, OpenRouter). • Containerize applications and examples using individual Dockerfiles or a unified docker-compose setup. • Integrate observability/tracing providers (OpenTelemetry, Langfuse, or AgentOps) for crewAI workflow execution. • Implement standardized testing, linting, and quality gates using pytest, ruff, and mypy at the root. | py-ai |
| py-audio | Python | A parent workspace directory housing multiple active and legacy audio projects (freesound, animusic-editor, pyCrossfade, pydub-ng, and legacy backups) | • Deprecate and delete obsolete legacy directories (z_beets.OLD, z_beets_obsolete_2025-10-03, z_beez_legacy) • Configure production credentials, environment files, and persistent Docker volumes for freesound • Decouple animusic-editor logic from PySimpleGUI and remove platform-specific bundled binaries (ffmpeg.exe) • Upgrade pyCrossfade dependency versions and wrap resource-heavy beat tracking operations in an asynchronous task queue • Verify target system availability of ffmpeg for library-level execution of pydub-ng • Conduct security and permissions audit on the /home/dev/py/audio directory structure | py-audio |
| py-img | Python | Contains two Python projects: a YOLO/SAM character segmenter and an image cheatsheet generator. | • Configure formal testing pipeline (e.g. pytest, CI integration) for Yolov8/SAM segmenters. • Implement production-grade error logging and structured logging instead of print statements. • Setup a mechanism to download or cache weights for YOLO/SAM models from external storage in production. • Expand the test suite to cover yolo_sam_segmenter.py and base_segmenter.py. • Standardize CLI tool interface and configuration management. | py-img |
| quicksheet | Python | Inactive / Broken virtual environment due to absolute path mismatch after project relocation | • Re-create or repair the Python virtual environment (.venv) to fix broken shebangs referencing /home/dev/active/quicksheet • Install Python dependencies via pip or poetry • Configure API keys (OpenRouter, Midjourney) and environment variables in the .env file • Compile Tailwind CSS/PostCSS assets using ‘npm run css:prod’ • Install git pre-commit hooks using ‘pre-commit install’ • Run the pytest suite to verify implementation correctness | quicksheet |
| storymatrix | Python | In development with multiple active pipeline blockers (CrewAI LLM configuration error, JSON serialization failures, and outdated unit tests) and root directory script clutter. | • Perform root directory workspace hygiene by cleaning/deleting ad-hoc python scripts (fix**.py, test**.py). • Fix the LiteLLM mock provider routing to prevent LLM Provider NOT provided BadRequestError. • Implement JSON serialization for NarrationSegment in ffmpeg_montage.py to resolve the serialization blocker. • Update tests/unit/application/services/test_audio_production_sfx_flag.py fixtures to align with AudioProductionService constructor parameters. • Resolve the image prompt generation crew bottleneck (e.g., simplify templates or use local mock pillow/deterministic prompt alternatives) to avoid timeouts. • Verify Timeline Guardrails and validators with the CrewRunner logs under a production run. • Complete pending SFX system improvements (Phase 1-4) and clean up cci: links and duplicate docs under the docs/ directory. | storymatrix |
| xray-example | Python | A demonstration/example Python project showing Clean Architecture, but missing production-ready components such as testing, error handling, logging, linters/formatters, dependency pinning, and CI/CD configuration. | • Create a comprehensive testing suite (unit, integration, E2E tests) using pytest. • Configure and integrate standard python logging for monitoring and debuggability. • Implement structured error handling and friendly error reporting in CLI and IO layers. • Configure code quality tools (Ruff, mypy) in pyproject.toml. • Pin dependencies and export requirements/lockfiles for reproducible builds. • Set up automated CI/CD pipelines (e.g., GitHub Actions) to run tests and linters. | xray-example |
| yt-dlp | Python | Ready for dependency installation, lazy extractor compilation, and package building. | • Create Python virtual environment • Install core and optional dependencies via install_deps.py • Generate lazy extractors using devscripts/make_lazy_extractors.py • Generate shell completions and manual page documentation via make doc and make completions • Run static analysis and tests to verify code validity • Build source distribution and wheel targets using hatch build | yt-dlp |
| GeniusGPT | Unknown | Bare configuration repository containing one JSON dataset (genius.json) with no packaging, tests, schemas, or docs. | • Initialize package manager configuration (e.g., package.json or pyproject.toml) • Define JSON Schema to validate persona dataset structural properties • Implement automated validation tests (e.g., unique ids, hex colors, required fields) • Write comprehensive documentation (README.md) on persona schema and usage • Build a typed loader/SDK layer to safely read and export configurations • Integrate validation and unit tests into CI/CD pipeline | GeniusGPT |
| audio-broadcast | Unknown | Partially configured dev environment for video/audio streaming with running Icecast but failing Liquidsoap sources. | • Deploy/place target media assets in a persistent read-accessible directory and update Liquidsoap playlists/scripts. • Resolve Liquidsoap encoder samplerate conflicts (Avutil.Error(Invalid argument)). • Change placeholder credentials in /etc/icecast2/icecast.xml and scripts to cryptographically secure secrets. • Configure SSL/TLS certificates and enable HTTPS connection support on Icecast. • Ensure Icecast runs under a restricted non-root user and configuration file permissions are secure. • Daemonize Liquidsoap using systemd service units for automatic recovery and startup. • Install bubblewrap (bwrap) to enable Liquidsoap process sandboxing. • Configure log rotation for the main log file to prevent disk capacity issues. • Set up monitoring for CPU, listener count, and stream status. | audio-broadcast |
| gitlists | Unknown | Contains only lists of Git repositories | • No codebase or preparation steps required | gitlists |
| hugdown | Unknown | Contains system documentation, bug reports, and prompt guidelines for GIGO. | • Consolidate redundant resolved/active bug documents into history logs. • Clean up internal/draft prompt assets like websim-proompt.md. • Configure a static site generator (Hugo/Quartz) to build and host the docs. • Fix cross-references and broken relative hyperlinks to external folders. • Sanitize private host names, internal IP addresses, and open ports. | hugdown |
| hugdown-prompt-assets | Unknown | Contains unsorted prompt templates, GPT leaks, and utility snippets in markdown format | • Establish Genius_Proomptz_Clean.md as canonical prompt library • Move single-topic cheat sheets to dedicated cheatsheets folder • Organize utility snippets and specialized tools into snippets and toolbox folders • Generate a central index file mapping all prompt files and domains • Sanitize leaked prompts and flag sensitive or jailbreaky entries | hugdown-prompt-assets |
| stomat_jamstuff | Unknown | deprecated_archive | • No preparation steps are needed as this directory is explicitly designated as an Obsolete Code Archive. • Ensure no production code imports or references any files or scripts from this directory. • Adhere to the retention policy of 90 days unless marked for preservation. • Perform quarterly reviews for cleanup opportunities. | stomat_jamstuff |