Summary

codex-console addresses recent instabilities in OpenAI's account registration and login processes, offering a more robust and reliable integrated console. It functions as a maintained and enhanced fork of cnlimiter/codex-manager, specifically targeting users needing to automate account creation, token acquisition, and related tasks. The project aims to fix common failure points in the current OpenAI registration flow, providing a stable, user-friendly tool for these operations.

How It Works

This project enhances the upstream codex-manager by adapting to recent OpenAI registration flow changes. Key technical adjustments include implementing Sentinel POW solving logic, separating registration from immediate token retrieval into distinct registration and login steps, correcting duplicate verification code handling, and refining page navigation during re-login attempts. These modifications ensure compatibility with current OpenAI API behaviors, establishing a more stable foundation for automated account management.

Quick Start & Requirements

• Environment: Python 3.10+ required. uv is recommended for dependency management.
• Installation: Use uv sync or pip install -r requirements.txt.
• Configuration: Set environment variables or modify the .env file for database URL, host, port, and access password.
• Running: Execute python webui.py with optional flags for host, port, debug mode, and access password.
• Docker: Deploy using docker-compose up -d or docker run, ensuring volume mapping for data persistence.
• Packaging: Build standalone executables for Windows (build.bat), Linux/macOS (build.sh).
• Community: QQ group available at https://qm.qq.com/q/ZTCKxawxeo.

Highlighted Details

• Integrates Sentinel POW solving logic crucial for current OpenAI registrations.
• Features a Web UI for managing batch registrations, real-time logs, and tasks.
• Supports flexible data storage with SQLite and remote PostgreSQL.
• Enables packaging into cross-platform executables (Windows, Linux, macOS).

Maintenance & Community

This repository is positioned as a "fixed and enhanced version" and a "compatibility and maintenance version" of cnlimiter/codex-manager, focusing on current OpenAI registration link issues. Community support is channeled through a QQ group.

Licensing & Compatibility

No explicit open-source license is provided in the documentation. The project's disclaimer suggests usage is intended for "learning, research, and technical exchange," implying potential restrictions on commercial use or integration into closed-source systems. Users are responsible for adhering to OpenAI's terms of service.

Limitations & Caveats

The project's scope is narrowly focused on maintaining compatibility with recent OpenAI registration and login procedures. Its utility is directly dependent on the evolving nature of these OpenAI processes. The absence of a formal license may pose adoption blockers for commercial or enterprise use cases. Users must ensure compliance with all relevant platform terms of service.