The latest articles on DEV Community by fajardev-tech (@fajardevtech). https://dev.to/fajardevtech https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4003218%2F6f95d66d-4c88-469d-be26-9590acdbf370.png https://dev.to/fajardevtech en fajardev-tech Fri, 26 Jun 2026 03:31:46 +0000 https://dev.to/fajardevtech/i-built-a-zero-dependency-python-library-for-otp-codes-ki6 https://dev.to/fajardevtech/i-built-a-zero-dependency-python-library-for-otp-codes-ki6 <h2> The Problem </h2> <p>Every automation project hits the same wall: <strong>OTP verification</strong>.</p> <p>You're building a bot, a scraper, an automation tool — and then you need to verify an account. GitHub, Google, Discord, OpenAI... they all want a code sent to your email.</p> <p>Your options:</p> <ul> <li> <strong>SMS gateways</strong> — cost money, rate limited</li> <li> <strong>Third-party APIs</strong> — another dependency, another failure point</li> <li> <strong>Manual copy-paste</strong> — defeats the purpose of automation</li> </ul> <h2> The Solution: otp-gateway </h2> <p><a href="https://github.com/fajardev-tech/otp-gateway" rel="noopener noreferrer">otp-gateway</a> reads OTP codes directly from your inbox via IMAP.<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code>pip <span class="nb">install </span>otp-gateway </code></pre> </div> <p>No API keys. No external services. Just IMAP.</p> <h2> Quick Start </h2> <div class="highlight js-code-highlight"> <pre class="highlight python"><code><span class="kn">from</span> <span class="n">otp_gateway</span> <span class="kn">import</span> <span class="n">OTPGateway</span><span class="p">,</span> <span class="n">OTPConfig</span> <span class="n">config</span> <span class="o">=</span> <span class="nc">OTPConfig</span><span class="p">(</span> <span class="n">imap_email</span><span class="o">=</span><span class="sh">"</span><span class="s">you@gmail.com</span><span class="sh">"</span><span class="p">,</span> <span class="n">imap_password</span><span class="o">=</span><span class="sh">"</span><span class="s">your-app-password</span><span class="sh">"</span><span class="p">,</span> <span class="n">domain</span><span class="o">=</span><span class="sh">"</span><span class="s">yourdomain.com</span><span class="sh">"</span><span class="p">,</span> <span class="p">)</span> <span class="n">gw</span> <span class="o">=</span> <span class="nc">OTPGateway</span><span class="p">(</span><span class="n">config</span><span class="p">)</span> <span class="c1"># Generate an alias for the platform </span><span class="n">alias</span> <span class="o">=</span> <span class="n">gw</span><span class="p">.</span><span class="nf">generate_alias</span><span class="p">(</span><span class="sh">"</span><span class="s">github</span><span class="sh">"</span><span class="p">)</span> <span class="nf">print</span><span class="p">(</span><span class="n">alias</span><span class="p">)</span> <span class="c1"># "github-a7k2m3@yourdomain.com" </span> <span class="c1"># Use this email to sign up, then wait for the OTP </span><span class="n">result</span> <span class="o">=</span> <span class="n">gw</span><span class="p">.</span><span class="nf">wait_for_otp</span><span class="p">(</span><span class="n">alias</span><span class="p">,</span> <span class="n">timeout</span><span class="o">=</span><span class="mi">90</span><span class="p">)</span> <span class="nf">print</span><span class="p">(</span><span class="n">result</span><span class="p">[</span><span class="sh">"</span><span class="s">value</span><span class="sh">"</span><span class="p">])</span> <span class="c1"># "847291" </span></code></pre> </div> <h2> Features </h2> <ul> <li> <strong>13 OTP extraction patterns</strong> — digits, alphanumeric, multi-language</li> <li> <strong>30+ platform support</strong> — GitHub, Google, Discord, OpenAI, Anthropic, AWS, Azure, and more</li> <li> <strong>Verification link extraction</strong> — not just codes, but links too</li> <li> <strong>Alias generation</strong> — create unique emails for each platform</li> <li> <strong>Smart dedup</strong> — never returns the same OTP twice</li> <li> <strong>CLI included</strong> — <code>otp-gateway wait user@domain.com</code> </li> <li> <strong>Zero dependencies</strong> — only Python stdlib</li> </ul> <h2> Why Zero Dependencies? </h2> <p>In automation, every dependency is a risk:</p> <ul> <li>Version conflicts break your pipeline</li> <li>Supply chain attacks compromise your system</li> <li>Deployment complexity slows you down</li> </ul> <p>otp-gateway uses only Python's standard library. Copy the <code>otp_gateway/</code> folder into your project and it works.</p> <h2> CLI Usage </h2> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code><span class="c"># Wait for an OTP</span> <span class="nv">$ </span>otp-gateway <span class="nb">wait </span>github@yourdomain.com ⏳ Waiting <span class="k">for </span>OTP at github@yourdomain.com... ✅ OTP found: 847291 <span class="o">(</span>GitHub<span class="o">)</span> <span class="c"># Check for recent OTPs</span> <span class="nv">$ </span>otp-gateway check <span class="nt">--email</span> user@domain.com <span class="nt">--since</span> 5m <span class="c"># Generate an alias</span> <span class="nv">$ </span>otp-gateway <span class="nb">alias </span>github github-a7k2m3@yourdomain.com </code></pre> </div> <h2> Supported Platforms </h2> <p>GitHub, Google, Discord, OpenAI, Anthropic, DeepSeek, AWS, Azure, Vercel, Netlify, Cloudflare, DigitalOcean, HuggingFace, Stripe, and 15+ more. The pattern library is easily extensible.</p> <h2> Get Started </h2> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code>pip <span class="nb">install </span>otp-gateway </code></pre> </div> <ul> <li> <strong>GitHub</strong>: <a href="https://github.com/fajardev-tech/otp-gateway" rel="noopener noreferrer">github.com/fajardev-tech/otp-gateway</a> </li> <li> <strong>PyPI</strong>: <a href="https://pypi.org/project/otp-gateway/" rel="noopener noreferrer">pypi.org/project/otp-gateway</a> </li> <li> <strong>Landing page</strong>: <a href="https://fajardev-tech.github.io/otp-gateway/" rel="noopener noreferrer">fajardev-tech.github.io/otp-gateway</a> </li> </ul> <p>MIT licensed. PRs welcome.</p> <p><em>If you build automation tools, give it a try. If you find it useful, a star on GitHub means a lot.</em></p> python opensource automation productivity