Skip to content
View BangerSoul's full-sized avatar
:dependabot:
On vacation
:dependabot:
On vacation

Block or report BangerSoul

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
BangerSoul/README.md

Hi, I'm BangerSoul πŸ‘‹

Senior Backend & LLM Infrastructure Engineer | Open-Source Contributor

Available for Freelance Book a Call Python TypeScript FastAPI Docker

I build, audit, and scale resilient cloud backends, high-throughput LLM proxy gateways, and custom Model Context Protocol (MCP) integrations.
Proven track record contributing high-reliability solutions to enterprise repositories with tens of thousands of stars.

πŸ’Ό Available for Contracts β€’ πŸ› οΈ Case Studies β€’ ⚑ Tech Stack β€’ πŸ“« Get in Touch


πŸš€ Verified Open-Source Case Studies

I believe code speaks louder than buzzwords. Here are real-world architectural and resilience contributions deployed to production open-source engines:

1. πŸ›‘οΈ High-Throughput Connection Leak Fix in LiteLLM

  • Project: BerriAI/litellm (25,000+ ⭐ β€” Enterprise LLM Proxy Gateway)
  • Pull Request: #43888 β€” fix(transport): dispose unclosed aiohttp ClientSession on transport __del__
  • The Problem: High-concurrency client session eviction left underlying aiohttp.ClientSession instances open without deterministic cleanup. In production clusters routing millions of tokens, unclosed sessions generated runtime resource leak warnings and risked socket exhaustion under heavy cache turnover.
  • The Solution: Engineered safe asynchronous event-loop inspection and deterministic session disposal on transport cleanup. Enforced strict lint budgets (BLE001/S110 compliance), eliminated non-deterministic sleeps with deadline polling, and structured full regression coverage in the mapped unit test suite.
  • Outcome: 40+ CI checks 100% green, verified zero connection leaks across continuous proxy load tests.

2. ⚑ Keyset Pagination & Tombstone Crash Guard in Omi AI Wearables

  • Project: BasedHardware/omi (20,000+ ⭐ β€” Open-Source AI Wearable & Ecosystem)
  • Pull Request: #20016 β€” fix(backend): validate inputs, clamp pagination boundaries, and guard keyset tombstones in mcp_conversation_pages
  • The Problem: In hosted Model Context Protocol (MCP) conversation card streams, encountering soft-deleted tombstones or corrupted documents lacking created_at timestamps caused cursor position corruption (last_position = (None, doc.id)). The subsequent iteration threw an unhandled ValueError, crashing caller endpoints with silent 500 errors instead of advancing pagination. Furthermore, negative limits/offsets bypassed boundaries straight into Firestore.
  • The Solution: Implemented non-destructive keyset cursor caching, boundary clamping on query limits/offsets, fast-return logic for inverted date ranges, path traversal sanitization, and 18 hermetic unit tests.
  • Outcome: 18/18 hermetic tests passing, zero 500 crashes during MCP cursor pagination, official bounty proposal submitted.

3. πŸ’° Finops Ledger Resilience & Path Traversal Guard in Omi

  • Project: BasedHardware/omi (20,000+ ⭐ β€” Open-Source AI Wearable & Ecosystem)
  • Pull Request: #20020 β€” fix(backend): clamp non-negative costs, sanitize date paths, and harden llm_gateway_accounting
  • The Problem: In LLM gateway event accounting, negative cost values could decrement the organization's finops cost rollups via firestore.Increment(-X), while float USD estimates were dropped to 0 due to rigid int type checks. Furthermore, date strings containing slashes (/ or \) caused accidental Firestore subcollection injection in llm_gateway_user_days, and unhandled plan resolution exceptions risked dropping valid billing attempt records.
  • The Solution: Engineered non-negative cost clamping, safe float/numeric string parsing with boolean rejection, path separator sanitization on date strings and attempt IDs, and fail-open exception boundaries on usage plan resolution.
  • Outcome: 15/15 hermetic tests passing in 0.82s, 4/4 PR preflight checks passed, finops ledger integrity and single-collection index guarantees verified.

4. πŸ” MCP Token Cache & Base Key Protection in Omi

  • Project: BasedHardware/omi (20,000+ ⭐ β€” Open-Source AI Wearable & Ecosystem)
  • Pull Request: #20023 β€” fix(backend): validate identities, clamp index TTLs, and protect prefix keys in mcp_token_cache
  • The Problem: In hosted Model Context Protocol (MCP) OAuth token caching, missing fields in client identities caused unhandled KeyError crashes during valid session caching, while non-positive index TTLs caused Redis to immediately purge grant token indices. During grant revocation, empty/blank decoded token hashes produced the base prefix key mcp:oauth:at:, inadvertently wiping the base key namespace in Redis.
  • The Solution: Validated complete identity payload schemas, clamped grant index TTLs to positive values, guarded multi-token revocation against base key deletion, handled un-serializable payloads in HMAC integrity envelopes, and structured 41 hermetic unit tests.
  • Outcome: 41/41 unit tests passing in 2.20s, zero unhandled KeyError crashes on MCP OAuth caching, Redis base prefix keys protected from accidental revocation wipes.

πŸ’Ό Freelance & Consulting Services

Available for freelance contracts, fractional engineering, and scoped sprints:

Service What I Deliver Typical Engagement
LLM Gateway & Proxy Architecture Custom routing, fallback cascades (Claude β†’ Gemini β†’ DeepSeek β†’ Local Ollama), semantic caching, strict rate-limiting, and budget ratchets via LiteLLM / custom gateways. 1–3 Week Sprint
Custom MCP Server Development High-performance Model Context Protocol (MCP) tools, resources, and SSE streaming connectors for your proprietary APIs, databases, and internal workflows. 3–10 Days
Backend Resilience & API Hardening Concurrency contention mitigation, Firestore/PostgreSQL query optimization, Redis rate-limiting (Lua scripts), and eliminating unhandled 500 edge cases in Python/TypeScript. Architecture Audit or Sprint
Zero-Downtime Migration & CI/CD Automated pre-flight validation gates, Ruff/ESLint strict budgets, hermetic unit testing, and containerized Cloud Run / Docker pipelines. Retainer or Project

⚑ Core Technical Arsenal

  • Languages: Python (3.10–3.14), TypeScript, JavaScript, SQL, Bash.
  • Frameworks & Gateways: FastAPI, LiteLLM, Express, Node.js, Next.js, Starlette, Pydantic (v2).
  • Databases & Caching: Google Cloud Firestore, PostgreSQL, Redis (Pub/Sub & Lua scripting), Pinecone (Vector RAG).
  • Architecture & Protocols: Model Context Protocol (MCP), SSE (Server-Sent Events), WebSockets, REST, gRPC, OAuth2 / OIDC.
  • Testing & Quality Assurance: Pytest (Hermetic fakes & transactions), Vitest, Black, Ruff, ESLint, Playwright.
  • DevOps & Cloud: Docker, Kubernetes, Google Cloud Run, GitHub Actions CI/CD workflows.

🀝 Engagement Models

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚              ENGAGEMENT MODELS                β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚  ⚑ Milestone Sprint:  $1,500 – $3,500 / task β”‚
β”‚  πŸ›‘οΈ Fractional Monthly: $2,500 – $6,000 / mo  β”‚
β”‚  πŸ” Architecture Audit: $80 – $120 / hr       β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸš€ How to Work Together & Book a Sprint

Looking to eliminate connection leaks, build custom Model Context Protocol (MCP) tools, or harden your LLM gateway before the next scaling milestone?

The 3-Step Sprint Onboarding Process:

  1. Step 1: 15-Minute Architecture Teardown (Free)
  2. Step 2: Scoped 5-Day Milestone Sprint ($1,500 – $3,500)
    • Transparent, flat-rate pricing. Zero open-ended hourly billing.
    • 50% upfront deposit, 50% upon clean pull request merge and test verification.
  3. Step 3: Verification & Zero-Downtime Handoff
    • 100% hermetic unit test suites, zero CI/CD lint violations, and complete architectural documentation.

πŸ“« Direct Contact & Availability

  • Booking: cal.com/bangersoul
  • GitHub: @BangerSoul
  • Email: contact@bangersoul.dev (or via GitHub profile discussions)
  • Timezone Overlap: Flexible overlap with US (PST/EST) and Europe (CET/GMT)
  • Communication: Async-first, high-cadence PR deliverables with verifiable test proof

Built with engineering rigor and zero-tolerance for silent failures.

Popular repositories Loading

  1. EmberbirdOS EmberbirdOS Public

    An open-source Windows Subsystem for Android: Android-x86_64 in a QEMU+WHPX VM, each app in its own native Windows window.

    Python 2

  2. JobHunterAI JobHunterAI Public

    πŸ€– Autonomous job discovery engine & 9-site scraper fleet powered by Groq AI, Playwright, and Streamlit. Features auto-deduplication, ATS match scoring, recruiter contact finder, and Excel tracking.

    HTML 1 1

  3. Emberbird Emberbird Public

    Run Windows Subsystem For Android on your Windows 10 and Windows 11 PC using prebuilt binaries with Google Play Store (OpenGapps Pico) and Magisk (root solutions) built in.

    Python 1

  4. whatsapp-mtd-sales-automation whatsapp-mtd-sales-automation Public

    An automated Python engine for FMCG and Alco-Bev sales pacing, dynamic DRR calculations, and WhatsApp route-to-market ledger dispatching

    HTML

  5. Email-Bot Email-Bot Public

    Mail Automation: A privacy-first terminal UI to scan, clean, and manage your inbox using a deterministic rules engine.

    Python

  6. HRRecordsTerminal HRRecordsTerminal Public

    Forked from AsmaSulthana345/HRRecordsTerminal

    The **Enterprise HR Directory, Role Assignment & Records Maintenance System** is a full-stack Java web application built with **Servlets, JSP, and MySQL**.It provides a centralized platform for man…

    Java