mewisme-meta

Async Python SDK for the meta.go gRPC runtime.

from mewisme_meta import AppStateAuth, AppStateCookie, CookieAuth, MetaClient

async with await MetaClient.managed(runtime_path="/path/to/meta-runtime") as meta:
    session = await meta.create_session(CookieAuth({"c_user": "...", "xs": "..."}))
    events = meta.events(session.session_id)
    events.on("message", lambda event: print(event.message.message))

    snapshot = await meta.refresh_auth(
        session.session_id,
        AppStateAuth((AppStateCookie("c_user", "..."), AppStateCookie("xs", "..."))),
    )

    async for event in events:
        print(event.WhichOneof("payload"))

Sessions accept CookieAuth, AppStateAuth, or CredentialAuth. Credentials requires identifier, password, and exactly one of totp or otp. refresh_auth() rotates auth in-place without replacing the runtime session or SDK event streams; auth_snapshot() exports normalized cookies, AppState and Facebook session metadata.

Use await MetaClient.external(endpoint, token) to connect to an already running runtime. Managed mode resolves runtime_path, then META_RUNTIME_PATH, then the bundled mewisme-meta-runtime wheel, then meta-runtime on PATH. If none is available it fails locally without downloading anything.

Release builds pin mewisme-meta-runtime to the exact SDK version so pip installs a matching platform wheel. An explicitly installed runtime remains supported as an override; the protocol-major handshake still rejects incompatible binaries after launch.