maksimzayats

maksimzayats / acodex

Public

Typed Python SDK for the Codex CLI (sync/async, streaming JSONL events, structured items)

docs.acodex.dev agent ai automation cli codex
49
0
100% credibility
Found Feb 17, 2026 at 39 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

acodex is a Python library that makes it simple to run ongoing conversations with an AI coding agent, including live updates, organized outputs, image inputs, and safety settings.

How It Works

1
🔍 Discover acodex

You learn about acodex, an easy way to bring a smart AI coding helper into your Python projects for conversations and code assistance.

2
💻 Get AI helper ready

You set up the core AI tool on your computer so it's available whenever you need it.

3
📦 Add acodex helper

You quickly bring acodex into your Python setup with a simple addition.

4
🚀 Launch your first chat

You start a new back-and-forth with the AI, asking it to summarize code or solve problems, feeling the magic as it responds.

5
💬 Chat and get smart help

You keep the conversation going, watching live updates, tool uses, and getting neatly organized answers.

6
🔄 Resume anytime

You pick up the exact same chat later using its special name, jumping right back in without starting over.

✅ Code smarter, faster

Your projects move quicker with the AI handling tough tasks, reasoning steps, and suggestions just like a helpful teammate.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 39 to 49 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is acodex?

acodex is a typed Python SDK that wraps the Codex CLI for running AI agent threads in your Python code. It handles spawning the CLI process, streaming JSONL events over stdin/stdout, and parsing structured outputs, with sync/async clients, image inputs, resumable sessions, and safety controls like sandbox modes. Python devs get a clean, mypy-strict interface instead of shelling out to codex commands or wrestling with loosely typed github JS SDKs.

Why is it gaining traction?

It delivers full API parity with the TypeScript SDK via automated compatibility tests, plus Python-specific perks like Pydantic for structured output and python typeddict validation on responses. Streaming events let you react to tool calls or errors in real-time, and explicit options for approval policies or web search beat raw CLI hacks. For typed python array handling or python typed parameters in agent inputs, it's a definite upgrade over untyped wrappers.

Who should use this?

Python backend engineers building Codex-powered tools, like automated code reviews or terminal agents via acodex terminal integration. DevOps folks scripting ascodex ls or dx workflows with safety rails, or anyone fixing "acodex server command not found" by embedding it directly. Ideal for python type class enthusiasts wanting resumable threads without JS interop.

Verdict

Grab it if you need typed Python access to Codex CLI now—docs are solid, tests hit 100% coverage, Apache 2.0 license. But with 39 stars and 1.0% credibility score, it's early beta; watch for stability as adoption grows.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.