iaurora 1.0.0

package/LICENSE

@@ -0,0 +1,201 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction,
+and distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by
+the copyright owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all
+other entities that control, are controlled by, or are under common
+control with that entity. For the purposes of this definition,
+"control" means (i) the power, direct or indirect, to cause the
+direction or management of such entity, whether by contract or
+otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity
+exercising permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications,
+including but not limited to software source code, documentation
+source, and configuration files.
+
+"Object" form shall mean any form resulting from mechanical
+transformation or translation of a Source form, including but
+not limited to compiled object code, generated documentation,
+and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or
+Object form, made available under the License, as indicated by a
+copyright notice that is included in or attached to the work
+(an example is provided in the Appendix below).
+
+"Derivative Works" shall mean any work, whether in Source or Object
+form, that is based on (or derived from) the Work and for which the
+editorial revisions, annotations, elaborations, or other modifications
+represent, as a whole, an original work of authorship. For the purposes
+of this License, Derivative Works shall not include works that remain
+separable from, or merely link (or bind by name) to the interfaces of,
+the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including
+the original version of the Work and any modifications or additions
+to that Work or Derivative Works thereof, that is intentionally
+submitted to Licensor for inclusion in the Work by the copyright owner
+or by an individual or Legal Entity authorized to submit on behalf of
+the copyright owner. For the purposes of this definition, "submitted"
+means any form of electronic, verbal, or written communication sent
+to the Licensor or its representatives, including but not limited to
+communication on electronic mailing lists, source code control systems,
+and issue tracking systems that are managed by, or on behalf of, the
+Licensor for the purpose of discussing and improving the Work, but
+excluding communication that is conspicuously marked or otherwise
+designated in writing by the copyright owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity
+on behalf of whom a Contribution has been received by Licensor and
+subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+copyright license to reproduce, prepare Derivative Works of,
+publicly display, publicly perform, sublicense, and distribute the
+Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+(except as stated in this section) patent license to make, have made,
+use, offer to sell, sell, import, and otherwise transfer the Work,
+where such license applies only to those patent claims licensable
+by such Contributor that are necessarily infringed by their
+Contribution(s) alone or by combination of their Contribution(s)
+with the Work to which such Contribution(s) was submitted. If You
+institute patent litigation against any entity (including a
+cross-claim or counterclaim in a lawsuit) alleging that the Work
+or a Contribution incorporated within the Work constitutes direct
+or contributory patent infringement, then any patent licenses
+granted to You under this License for that Work shall terminate
+as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+Work or Derivative Works thereof in any medium, with or without
+modifications, and in Source or Object form, provided that You
+meet the following conditions:
+
+(a) You must give any other recipients of the Work or
+Derivative Works a copy of this License; and
+
+(b) You must cause any modified files to carry prominent notices
+stating that You changed the files; and
+
+(c) You must retain, in the Source form of any Derivative Works
+that You distribute, all copyright, patent, trademark, and
+attribution notices from the Source form of the Work,
+excluding those notices that do not pertain to any part of
+the Derivative Works; and
+
+(d) If the Work includes a "NOTICE" text file as part of its
+distribution, then any Derivative Works that You distribute must
+include a readable copy of the attribution notices contained
+within such NOTICE file, excluding those notices that do not
+pertain to any part of the Derivative Works, in at least one
+of the following places: within a NOTICE text file distributed
+as part of the Derivative Works; within the Source form or
+documentation, if provided along with the Derivative Works; or,
+within a display generated by the Derivative Works, if and
+wherever such third-party notices normally appear. The contents
+of the NOTICE file are for informational purposes only and
+do not modify the License. You may add Your own attribution
+notices within Derivative Works that You distribute, alongside
+or as an addendum to the NOTICE text from the Work, provided
+that such additional attribution notices cannot be construed
+as modifying the License.
+
+You may add Your own copyright statement to Your modifications and
+may provide additional or different license terms and conditions
+for use, reproduction, or distribution of Your modifications, or
+for any such Derivative Works as a whole, provided Your use,
+reproduction, and distribution of the Work otherwise complies with
+the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+any Contribution intentionally submitted for inclusion in the Work
+by You to the Licensor shall be under the terms and conditions of
+this License, without any additional terms or conditions.
+Notwithstanding the above, nothing herein shall supersede or modify
+the terms of any separate license agreement you may have executed
+with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+names, trademarks, service marks, or product names of the Licensor,
+except as required for reasonable and customary use in describing the
+origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+agreed to in writing, Licensor provides the Work (and each
+Contributor provides its Contributions) on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+implied, including, without limitation, any warranties or conditions
+of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+PARTICULAR PURPOSE. You are solely responsible for determining the
+appropriateness of using or redistributing the Work and assume any
+risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+whether in tort (including negligence), contract, or otherwise,
+unless required by applicable law (such as deliberate and grossly
+negligent acts) or agreed to in writing, shall any Contributor be
+liable to You for damages, including any direct, indirect, special,
+incidental, or consequential damages of any character arising as a
+result of this License or out of the use or inability to use the
+Work (including but not limited to damages for loss of goodwill,
+work stoppage, computer failure or malfunction, or any and all
+other commercial damages or losses), even if such Contributor
+has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+the Work or Derivative Works thereof, You may choose to offer,
+and charge a fee for, acceptance of support, warranty, indemnity,
+or other liability obligations and/or rights consistent with this
+License. However, in accepting such obligations, You may act only
+on Your own behalf and on Your sole responsibility, not on behalf
+of any other Contributor, and only if You agree to indemnify,
+defend, and hold each Contributor harmless for any liability
+incurred by, or claims asserted against, such Contributor by reason
+of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+To apply the Apache License to your work, attach the following
+boilerplate notice, with the fields enclosed by brackets "[]"
+replaced with your own identifying information. (Don't include
+the brackets!) The text should be enclosed in the appropriate
+comment syntax for the file format. We also recommend that a
+file or class name and description of purpose be included on the
+same "printed page" as the copyright notice for easier
+identification within third-party archives.
+
+Copyright 2025 Gurveer
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,231 @@
+<div align="center">
+
+<img alt="Aurora OSS" src="dashboard-ui/public/aurora-oss-logo.svg" width="72">
+
+# Aurora OSS
+
+**One gateway. Every provider. Open source.**
+
+Route AI traffic through a single OpenAI- and Anthropic-compatible API.
+Self-hosted. No vendor lock-in. Full source visibility.
+
+<table>
+<tr>
+  <td><a href="https://github.com/gurveeer/Aurora/actions/workflows/test.yml"><img src="https://github.com/gurveeer/Aurora/actions/workflows/test.yml/badge.svg" alt="CI"></a></td>
+  <td><a href="https://github.com/gurveeer/Aurora/blob/main/go.mod"><img src="https://img.shields.io/github/go-mod/go-version/gurveeer/Aurora?style=flat-square&label=Go" alt="Go Version"></a></td>
+  <td><a href="https://github.com/gurveeer/Aurora/releases"><img src="https://img.shields.io/github/v/release/gurveeer/Aurora?style=flat-square" alt="Release"></a></td>
+  <td><a href="https://github.com/gurveeer/Aurora/stargazers"><img src="https://img.shields.io/github/stars/gurveeer/Aurora?style=flat-square" alt="Stars"></a></td>
+</tr>
+<tr>
+  <td><a href="LICENSE"><img src="https://img.shields.io/github/license/gurveeer/Aurora?style=flat-square" alt="License"></a></td>
+  <td><a href="https://hub.docker.com/r/gurveeer/Aurora"><img src="https://img.shields.io/docker/pulls/gurveeer/Aurora?style=flat-square" alt="Docker Pulls"></a></td>
+  <td><a href="https://github.com/gurveeer/Aurora/commits/main"><img src="https://img.shields.io/github/last-commit/gurveeer/Aurora?style=flat-square" alt="Last Commit"></a></td>
+  <td><a href="https://github.com/gurveeer/Aurora/issues"><img src="https://img.shields.io/github/issues/gurveeer/Aurora?style=flat-square" alt="Open Issues"></a></td>
+</tr>
+<tr>
+  <td><a href="https://github.com/gurveeer/Aurora/pulls"><img src="https://img.shields.io/badge/PRs-Welcome-brightgreen?style=flat-square" alt="PRs Welcome"></a></td>
+  <td><a href="https://discord.gg/gaEB9BQSPH"><img src="https://img.shields.io/badge/Discord-Join-5865F2?style=flat-square&logo=discord&logoColor=white" alt="Discord"></a></td>
+  <td></td>
+  <td></td>
+</tr>
+</table>
+
+<a href="docs/assets/dashboard-overview.png">
+  <img src="docs/assets/dashboard-overview.png" alt="Aurora dashboard" width="100%">
+</a>
+
+</div>
+
+---
+
+## Get running in 30 seconds
+
+**Docker**
+
+```bash
+docker run --rm -p 8080:8080 \
+  -e OPENAI_API_KEY="sk-..." \
+  gurveeer/Aurora
+```
+
+**From source**
+
+```bash
+git clone https://github.com/gurveeer/Aurora.git && cd Aurora
+pnpm --dir dashboard-ui install && pnpm --dir dashboard-ui run build
+go build -o bin/aurora-oss.exe ./apps/aurora
+```
+
+Then send your first request:
+
+```bash
+curl http://localhost:8080/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -d '{"model":"gpt-5-chat-latest","messages":[{"role":"user","content":"Hello!"}]}'
+```
+
+| | |
+|---|---|
+| Dashboard | `http://localhost:8080/admin/dashboard` |
+| Health check | `http://localhost:8080/health` |
+| Swagger | `http://localhost:8080/swagger/index.html` |
+
+---
+
+## What it does
+
+Aurora sits between your application and AI providers. One API key, one endpoint, every model.
+
+<p align="center">
+  <a href="docs/assets/analytics-overview.png">
+    <img src="docs/assets/analytics-overview.png" alt="Usage analytics" width="48%">
+  </a>
+  <a href="docs/assets/audit-logs.png">
+    <img src="docs/assets/audit-logs.png" alt="Audit logs" width="48%">
+  </a>
+</p>
+
+**Unified API** -- `/v1/chat/completions`, `/v1/responses`, `/v1/embeddings`, `/v1/models`, `/v1/files`, `/v1/batches`
+
+**12 providers** -- OpenAI, Anthropic, Gemini, DeepSeek, Groq, OpenRouter, Z.ai, xAI, Azure OpenAI, Oracle, Ollama, vLLM (and any OpenAI-compatible backend)
+
+**Routing** -- Model aliases, provider pools, fallback chains, workflow pipelines, passthrough routes
+
+**Dashboard** -- Live usage analytics, provider status, cache hit rates, cost tracking, audit logs
+
+**Controls** -- Managed API keys, model overrides, guardrails, pricing recalculation, exact + semantic response caching
+
+**Storage** -- SQLite (default), PostgreSQL, MongoDB
+
+---
+
+## Providers
+
+| Provider | Key | Chat | Embeddings | Files | Batches | Passthrough |
+|---|---|:---:|:---:|:---:|:---:|:---:|
+| OpenAI | `OPENAI_API_KEY` | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Anthropic | `ANTHROPIC_API_KEY` | ✅ | | | ✅ | ✅ |
+| Google Gemini | `GEMINI_API_KEY` | ✅ | ✅ | ✅ | ✅ | |
+| DeepSeek | `DEEPSEEK_API_KEY` | ✅ | | | | |
+| Groq | `GROQ_API_KEY` | ✅ | ✅ | ✅ | ✅ | |
+| OpenRouter | `OPENROUTER_API_KEY` | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Z.ai | `ZAI_API_KEY` | ✅ | ✅ | | | ✅ |
+| xAI | `XAI_API_KEY` | ✅ | ✅ | ✅ | ✅ | |
+| Azure OpenAI | `AZURE_API_KEY` + `AZURE_BASE_URL` | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Oracle | `ORACLE_API_KEY` + `ORACLE_BASE_URL` | ✅ | | | | |
+| Ollama | `OLLAMA_BASE_URL` | ✅ | ✅ | | | |
+| vLLM | `VLLM_BASE_URL` | ✅ | ✅ | | | ✅ |
+
+> **Z.ai GLM Coding Plan:** set `ZAI_BASE_URL=https://api.z.ai/api/coding/paas/v4`
+>
+> **Multiple instances of one provider?** Use suffixed env vars: `OPENAI_EAST_API_KEY`, `OPENAI_EAST_BASE_URL`, `OPENAI_EAST_MODELS`
+
+---
+
+## Configuration
+
+Aurora loads config in order: **defaults → YAML → env vars** (env vars win).
+
+```bash
+# Copy the template
+cp .env.template .env
+
+# Pick a config profile
+cp configs/editions/oss.example.yaml configs/config.yaml
+```
+
+| Profile | Best for | External services |
+|---|---|---|
+| [`oss.example.yaml`](configs/editions/oss.example.yaml) | First run, individual devs | None |
+| [`oss.local-power.example.yaml`](configs/editions/oss.local-power.example.yaml) | Local power users (cache, metrics, audit) | Redis |
+| [`oss.team.example.yaml`](configs/editions/oss.team.example.yaml) | Small self-hosted teams | PostgreSQL, Redis, Qdrant |
+
+**Key settings:**
+
+| Setting | Default | What it does |
+|---|---|---|
+| `PORT` | `8080` | Listen port |
+| `AURORA_MASTER_KEY` | -- | Gateway/admin API key (set before exposing outside localhost) |
+| `STORAGE_TYPE` | `sqlite` | `sqlite`, `postgresql`, or `mongodb` |
+| `LOGGING_ENABLED` | `false` | Audit logging |
+| `METRICS_ENABLED` | `false` | Prometheus metrics |
+| `GUARDRAILS_ENABLED` | `false` | Guardrail workflows |
+| `ENABLE_PASSTHROUGH_ROUTES` | `true` | `/p/{provider}/...` passthrough |
+
+Full reference: [`configs/config.example.yaml`](configs/config.example.yaml)
+
+---
+
+## Response caching
+
+Two layers, both optional:
+
+- **Exact cache** -- hashes request path + body, returns `X-Cache: HIT (exact)` on identical requests. Enable with `RESPONSE_CACHE_SIMPLE_ENABLED` + Redis.
+- **Semantic cache** -- embeds prompts, searches vector store for similar requests. Returns `X-Cache: HIT (semantic)`. Supports `qdrant`, `pgvector`, `pinecone`, `weaviate`.
+
+Per-request bypass: `Cache-Control: no-cache` or `Cache-Control: no-store`.
+
+---
+
+## Docker Compose
+
+```bash
+# Infrastructure only (Redis, Qdrant, Postgres)
+docker compose up -d
+
+# Full stack (Aurora + infra)
+cp .env.template .env
+docker compose --profile app up -d
+
+# Local image build
+docker build -t aurora-oss .
+docker run --rm -p 8080:8080 --env-file .env aurora-oss
+```
+
+---
+
+## Build from source
+
+**Prerequisites:** Go 1.26.2+, Node.js + pnpm
+
+```bash
+# Dashboard
+pnpm --dir dashboard-ui install
+pnpm --dir dashboard-ui run build
+
+# Binary
+go build -o bin/aurora-oss.exe ./apps/aurora
+
+# Packaged release
+.\scripts\release\build-editions.ps1 -Package
+```
+
+Outputs: `bin/aurora-oss.exe`, `release/aurora-oss-windows-amd64.zip`
+
+**Tests:**
+
+```bash
+go test ./apps/... ./internal/...
+pnpm --dir dashboard-ui run build
+make oss-boundary-check
+```
+
+---
+
+## Enterprise
+
+Aurora OSS covers gateway routing, analytics, and provider operations. **Aurora Enterprise** adds SSO, RBAC, tenant isolation, budget enforcement, compliance workflows, and production support.
+
+The Enterprise edition is a separate distribution. It cannot be enabled by editing files in this OSS tree.
+
+---
+
+## Community
+
+| | |
+|---|---|
+| [Discord](https://discord.gg/gaEB9BQSPH) | Deployment questions, provider setup, roadmap |
+| [GitHub Issues](https://github.com/gurveeer/Aurora/issues) | Bug reports, feature requests |
+| [GitHub Stars](https://github.com/gurveeer/Aurora/stargazers) | Support the project |
+
+If Aurora saves your team time, a star helps others find it.

package/bin/aurora.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+import { spawn } from 'child_process';
+import { existsSync } from 'fs';
+import { createRequire } from 'module';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import os from 'os';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+const pkg = require(resolve(__dirname, '..', 'package.json'));
+
+function platformBinaryName() {
+  const ext = os.platform() === 'win32' ? '.exe' : '';
+  return `aurora${ext}`;
+}
+
+function resolveBinary() {
+  const name = platformBinaryName();
+  const candidates = [
+    process.env.AURORA_BINARY_PATH && resolve(process.env.AURORA_BINARY_PATH),
+    resolve(__dirname, name),
+    resolve(__dirname, '..', name),
+    resolve(__dirname, '..', 'bin', name),
+    resolve(os.homedir(), '.aurora', 'bin', name),
+    resolve(os.homedir(), '.cache', 'aurora', name),
+  ].filter(Boolean);
+
+  for (const candidate of candidates) {
+    if (existsSync(candidate)) return candidate;
+  }
+  return null;
+}
+
+function suggestInstall() {
+  console.error(`
+Aurora binary not found.
+
+Run:  npx iaurora install
+
+Or build manually (requires Go 1.26.2+):
+  git clone https://github.com/gurveeer/Aurora.git
+  cd Aurora
+  go build -o bin/aurora ./apps/aurora
+  set AURORA_BINARY_PATH to the binary path
+
+`);
+  process.exit(1);
+}
+
+function run(args) {
+  const binary = resolveBinary();
+  if (!binary) {
+    if (args[0] === 'install' || args[0] === 'download') {
+      downloadBinary(args.slice(1));
+      return;
+    }
+    if (args[0] === '--help' || args[0] === '-h') {
+      printHelp();
+      return;
+    }
+    suggestInstall();
+    return;
+  }
+
+  if (args[0] === '--help' || args[0] === '-h') {
+    printHelp();
+    return;
+  }
+
+  const child = spawn(binary, args, {
+    stdio: 'inherit',
+    env: { ...process.env },
+  });
+
+  child.on('exit', (code) => process.exit(code ?? 1));
+  child.on('error', (err) => {
+    console.error('Failed to start binary:', err.message);
+    process.exit(1);
+  });
+}
+
+function printHelp() {
+  console.error(`
+${pkg.name} v${pkg.version}
+
+Usage: npx ${pkg.name} [command] [options]
+
+Commands:
+  start          Start the Aurora gateway server (default)
+  install        Download the Aurora binary for your platform
+  models sync    Sync model registry from upstream
+  models diff    Compare local vs upstream model pricing
+  models show    Show model pricing details
+  --help, -h     Show this help
+  --version, -v  Show version
+
+Environment:
+  AURORA_BINARY_PATH  Path to the Aurora binary (bypasses search)
+  AURORA_CONFIG_PATH  Path to config YAML (default: configs/editions/oss.example.yaml)
+
+Documentation: https://github.com/gurveeer/Aurora
+`);
+  process.exit(0);
+}
+
+async function downloadBinary(args) {
+  const { downloadAndInstall } = await import('../scripts/npm-postinstall.js');
+  try {
+    await downloadAndInstall({
+      force: args.includes('--force'),
+    });
+    console.error('Binary installed to ~/.aurora/bin/');
+    console.error('Run `npx iaurora start` to launch the server.');
+    process.exit(0);
+  } catch (err) {
+    console.error('Download failed:', err.message);
+    process.exit(1);
+  }
+}
+
+run(process.argv.slice(2));

package/config.yaml

@@ -0,0 +1,55 @@
+# Aurora OSS minimal local profile
+# Usage: $env:AURORA_CONFIG_PATH = "configs/editions/oss.example.yaml"; go run ./apps/aurora
+# Goal: start with no external dependencies. Use provider env vars such as OPENAI_API_KEY or GROQ_API_KEY.
+
+edition:
+  name: oss
+
+server:
+  port: "8080"
+  base_path: "/"
+  master_key: "${AURORA_MASTER_KEY}"
+  enable_passthrough_routes: true
+  allow_passthrough_v1_alias: true
+  enabled_passthrough_providers: ["openai", "anthropic", "openrouter", "zai", "vllm"]
+
+admin:
+  endpoints_enabled: true
+  ui_enabled: true
+  dashboard_variant: "react"
+
+models:
+  enabled_by_default: true
+  overrides_enabled: true
+  configured_provider_models_mode: "fallback"
+
+storage:
+  type: "sqlite"
+  sqlite:
+    path: "data/aurora-oss.db"
+
+logging:
+  enabled: false
+  log_bodies: false
+  log_headers: false
+  only_model_interactions: true
+
+usage:
+  enabled: true
+  pricing_recalculation_enabled: true
+  enforce_returning_usage_data: true
+
+metrics:
+  enabled: false
+  endpoint: "/metrics"
+
+guardrails:
+  enabled: false
+  enable_for_batch_processing: false
+
+cache:
+  model:
+    refresh_interval: 3600
+
+workflows:
+  refresh_interval: 1m

package/package.json

@@ -0,0 +1,42 @@
+{
+    "version":  "1.0.0",
+    "author":  "SantiagoDePolonia",
+    "license":  "Apache-2.0",
+    "files":  [
+                  "bin/",
+                  "scripts/",
+                  "config.yaml",
+                  "README.md",
+                  "LICENSE"
+              ],
+    "keywords":  [
+                     "ai",
+                     "llm",
+                     "gateway",
+                     "openai",
+                     "anthropic",
+                     "gemini",
+                     "proxy",
+                     "api-gateway"
+                 ],
+    "name":  "iaurora",
+    "type":  "module",
+    "bugs":  {
+                 "url":  "https://github.com/gurveeer/Aurora/issues"
+             },
+    "description":  "Aurora AI Gateway - one API for every LLM provider. Self-hosted, open-source.",
+    "engines":  {
+                    "node":  "\u003e=18"
+                },
+    "scripts":  {
+                    "postinstall":  "node ./scripts/npm-postinstall.js"
+                },
+    "homepage":  "https://github.com/gurveeer/Aurora#readme",
+    "repository":  {
+                       "type":  "git",
+                       "url":  "git+https://github.com/gurveeer/Aurora.git"
+                   },
+    "bin":  {
+                "aurora":  "./bin/aurora.js"
+            }
+}

package/scripts/npm-postinstall.js

@@ -0,0 +1,98 @@
+import { existsSync, mkdirSync, writeFileSync, chmodSync } from 'fs';
+import { get } from 'https';
+import { resolve, join, dirname } from 'path';
+import { createRequire } from 'module';
+import { fileURLToPath } from 'url';
+import os from 'os';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const require = createRequire(import.meta.url);
+const pkg = require(resolve(__dirname, '..', 'package.json'));
+
+const GITHUB_REPO = 'gurveeer/Aurora';
+const BINARY_DIR = join(os.homedir(), '.aurora', 'bin');
+
+function platformAssetName() {
+  const platform = os.platform();
+  const arch = os.arch();
+
+  const map = {
+    'win32-x64': 'aurora-windows-amd64.exe',
+    'win32-arm64': 'aurora-windows-arm64.exe',
+    'darwin-x64': 'aurora-darwin-amd64',
+    'darwin-arm64': 'aurora-darwin-arm64',
+    'linux-x64': 'aurora-linux-amd64',
+    'linux-arm64': 'aurora-linux-arm64',
+  };
+
+  const key = `${platform}-${arch}`;
+  if (!map[key]) {
+    throw new Error(`Unsupported platform: ${key}`);
+  }
+  return map[key];
+}
+
+function getBinaryName() {
+  return os.platform() === 'win32' ? 'aurora.exe' : 'aurora';
+}
+
+function getDownloadUrl(version) {
+  const asset = platformAssetName();
+  const tag = version || `v${pkg.version}`;
+  return `https://github.com/${GITHUB_REPO}/releases/download/${tag}/${asset}`;
+}
+
+function download(url) {
+  return new Promise((resolve, reject) => {
+    get(url, (response) => {
+      if (response.statusCode >= 300 && response.statusCode < 400 && response.headers.location) {
+        download(response.headers.location).then(resolve, reject);
+        return;
+      }
+      if (response.statusCode !== 200) {
+        reject(new Error(`HTTP ${response.statusCode} for ${url}`));
+        return;
+      }
+      const chunks = [];
+      response.on('data', (c) => chunks.push(c));
+      response.on('end', () => resolve(Buffer.concat(chunks)));
+      response.on('error', reject);
+    }).on('error', reject);
+  });
+}
+
+export async function downloadAndInstall(opts = {}) {
+  const { force, version } = opts;
+  const binaryName = getBinaryName();
+  const binaryPath = join(BINARY_DIR, binaryName);
+
+  if (!force && existsSync(binaryPath)) {
+    return;
+  }
+
+  if (!existsSync(BINARY_DIR)) {
+    mkdirSync(BINARY_DIR, { recursive: true });
+  }
+
+  const url = getDownloadUrl(version);
+  console.error(`Downloading Aurora ${version || `v${pkg.version}`}...`);
+  const data = await download(url);
+  writeFileSync(binaryPath, data);
+  if (os.platform() !== 'win32') {
+    chmodSync(binaryPath, 0o755);
+  }
+}
+
+async function main() {
+  try {
+    await downloadAndInstall();
+    console.error(`Aurora binary installed to ${join(BINARY_DIR, getBinaryName())}`);
+  } catch (err) {
+    console.error(`Warning: Could not download Aurora binary: ${err.message}`);
+    console.error('The CLI will attempt to use a locally built binary instead.');
+    console.error('Run `npx iaurora install` to retry.');
+  }
+}
+
+main();