git404hub

what is mimic fr?

littledivy/mimic — explained in plain English

Analysis updated 2026-05-18

1,445PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

tl;dr

mimic captures your own app's network traffic and uses AI to generate a Python client, so you can call any app's private API like a library.

vibe map

mindmap
  root((mimic))
    What it does
      Captures app traffic
      Generates Python client
      Replays captured auth
    Tech stack
      Python
      mitmproxy
      uv
    Capture methods
      mitmproxy iOS
      cURL paste
      HAR file
    Use cases
      Script a mobile API
      Automate a web app
      Reuse own session
    Limitations
      Certificate pinning
      DPoP tokens
    Audience
      Developers
      Own accounts only

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Turn a mobile app's private API into a Python library by capturing your own traffic.

VIBE 2

Automate an app that has no public API by replaying your own captured session.

VIBE 3

Build a script against a web app using a HAR file instead of an official API.

what's the stack?

Pythonmitmproxyuv

how it stacks up fr

littledivy/mimicanthropics/jacobian-lensvibeforge1111/keep-codex-fast
Stars1,4451,4341,456
LanguagePythonPythonPython
Last pushed2026-07-172026-05-06
MaintenanceActiveMaintained
Setup difficultymoderatemoderateeasy
Complexity3/54/52/5
Audiencedeveloperresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

iOS capture needs installing a mitmproxy certificate and trusting it on the device.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

mimic is a Python tool that turns any app's private API into a Python library you can call directly, without writing the client code by hand. Instead of reading network requests yourself and guessing how an app talks to its servers, you capture real traffic from your own use of the app, and mimic uses AI to generate a working Python client from what it saw. The idea behind it is that most apps send the same set of authentication values with every request: a token, device identifiers, a session id, cookies. These values stay stable across calls, so if you capture them once from a real request, you can reuse them to make new requests to the same API. mimic captures this traffic, pulls out the authentication details, and reads the captured endpoints to build named Python methods, including the multi step call chains some mobile APIs need, such as fetching a token in one call and spending it in the next. There are three ways to capture traffic. mitmproxy is the default and works well for iOS apps by intercepting requests sent from your phone. Pasting a request copied as cURL from browser developer tools works for anything with a web version. Saving a HAR file from a browser's network tab also needs no proxy setup at all. Once you have captured traffic, commands let you list which hosts you captured, see what endpoints were seen for a given host, and generate a Python client file for it. The generated client is ordinary Python code built on a base class, so once it exists you can edit it like any other file. If a request fails because a token expired, the library tries to refresh it once automatically, but only for requests that are safe to repeat. Two situations get in the way of this approach. Apps that use certificate pinning, such as banking apps, block the capture step entirely, though mimic includes a workaround for that case. Apps that use DPoP, where each request is signed by a private key that never leaves the device, cannot be replayed at all, since the signature itself cannot be captured and reused later. The README says the project is meant for use on your own accounts and data, and you are responsible for following each app's terms of service. It is released under the MIT license.

prompts (copy fr)

prompt 1
Walk me through installing mimic and running mimic doctor to check my setup.
prompt 2
Show me how to use mimic record to capture traffic from an iPhone app.
prompt 3
Explain how to generate a Python client with mimic gen once I have captured a host.
prompt 4
Help me build a mimic Session from a cURL command I copied out of Chrome devtools.

Frequently asked questions

what is mimic fr?

mimic captures your own app's network traffic and uses AI to generate a Python client, so you can call any app's private API like a library.

What language is mimic written in?

Mainly Python. The stack also includes Python, mitmproxy, uv.

What license does mimic use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is mimic to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is mimic for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.