NeoGate v0.1.2
NeoGate v0.1.2 introduces project-centered governance, a more consistent admin console, and stronger relay, billing, and image-task behavior for private production deployments.
Highlights
- Added Projects as the primary unit for members, API keys, balances, usage attribution, and cost analysis.
- Added an admin Projects page for creating projects, assigning owners and members, switching project status, adjusting project balances, and viewing project-level key counts.
- Added project member API keys so each project member can receive a scoped key while shared project ownership remains clear.
- Aligned paid-mode credit flows with the Project model, including project balances, project-level usage attribution, and improved paid-mode request handling.
- Improved user management with username support, project/key visibility, cleaner status controls, and more consistent pagination and action dialogs.
- Optimized the relay hot path and billing outbox throughput, including configurable usage buffering, improved cache boundaries, and better request-path logging.
- Added local background handling for OpenAI-compatible Responses image generation through NewAPI, including response status retrieval, cancellation, asset storage, and result reconstruction.
- Added concurrency limits for synchronous image requests with global and per-key controls.
- Improved OpenAI-compatible image relay behavior, async image response buffering, and Nginx streaming defaults for long-running model and image requests.
- Refined the admin console UI across channels, credentials, projects, users, usage, and settings with more consistent table layouts, status switches, pagination bars, scroll behavior, and confirmation dialogs.
- Expanded public API documentation and README presentation, including clearer enterprise private deployment positioning and richer interface examples.
- Added design documentation for the Project model and Billing Outbox flow.
- Reorganized backend tests into smoke and benchmark folders, with Chinese and English test documentation.
Upgrade Notes
- Rebuild Docker images after pulling this release so the backend, frontend, and Nginx runtime config are updated together.
- Use the new admin Projects page for project balances, member management, and project-scoped API key operations.
- If you use background Responses image generation with NewAPI, keep
NEOGATE_ASSET_DIRon persistent writable storage. The default isdata/assets. - In distributed deployments, keep a worker process running because background response jobs, upstream task polling, usage aggregation, and billing outbox processing depend on worker execution.
- Review the new optional tuning variables when running high-volume image workloads:
NEOGATE_RESPONSE_RETENTION_SECONDSNEOGATE_IMAGE_SYNC_GLOBAL_LIMITNEOGATE_IMAGE_SYNC_KEY_LIMITRELAY_USAGE_BUFFER_LIMIT_BYTESUPSTREAM_TIMEOUT_SECONDS
- If you maintain custom Nginx files, copy the streaming timeout and buffering settings from
deploy/nginx/compose.conf.templateordeploy/nginx/standalone.conf.example.
Version
- Target branch:
main - Tag:
v0.1.2 - License:
AGPL-3.0-only