Skip to content

NeoGate v0.1.2

Choose a tag to compare

@neogate-io neogate-io released this 13 Jun 15:10
· 43 commits to main since this release

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_DIR on persistent writable storage. The default is data/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_SECONDS
    • NEOGATE_IMAGE_SYNC_GLOBAL_LIMIT
    • NEOGATE_IMAGE_SYNC_KEY_LIMIT
    • RELAY_USAGE_BUFFER_LIMIT_BYTES
    • UPSTREAM_TIMEOUT_SECONDS
  • If you maintain custom Nginx files, copy the streaming timeout and buffering settings from deploy/nginx/compose.conf.template or deploy/nginx/standalone.conf.example.

Version

  • Target branch: main
  • Tag: v0.1.2
  • License: AGPL-3.0-only