{"id":49465984,"url":"https://github.com/ivan-yuldashev/promtix","last_synced_at":"2026-04-30T12:35:33.560Z","repository":{"id":328119762,"uuid":"1113888965","full_name":"ivan-yuldashev/promtix","owner":"ivan-yuldashev","description":"Promtix is a self-hosted AI Gateway and Prompt Management System designed for privacy-conscious teams. It sits between your product code and LLM providers (OpenAI, Anthropic, etc.).","archived":false,"fork":false,"pushed_at":"2025-12-22T08:51:29.000Z","size":224,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-30T12:35:32.154Z","etag":null,"topics":["ai-gateway","anthropic-proxy","developer-tools","gemini-proxy","llm","llmops","openai-proxy","prompt-engineering","self-hosted"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ivan-yuldashev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-10T15:51:44.000Z","updated_at":"2026-03-11T05:24:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ivan-yuldashev/promtix","commit_stats":null,"previous_names":["ivan-yuldashev/promtix"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ivan-yuldashev/promtix","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivan-yuldashev%2Fpromtix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivan-yuldashev%2Fpromtix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivan-yuldashev%2Fpromtix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivan-yuldashev%2Fpromtix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ivan-yuldashev","download_url":"https://codeload.github.com/ivan-yuldashev/promtix/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivan-yuldashev%2Fpromtix/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32465009,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T22:27:22.272Z","status":"online","status_checked_at":"2026-04-30T02:00:05.929Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-gateway","anthropic-proxy","developer-tools","gemini-proxy","llm","llmops","openai-proxy","prompt-engineering","self-hosted"],"created_at":"2026-04-30T12:35:32.834Z","updated_at":"2026-04-30T12:35:33.552Z","avatar_url":"https://github.com/ivan-yuldashev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🛸 Promtix\n\n**The Open Source AI Gateway \u0026 Prompt Management System.**\n\nPromtix is a self-hosted, privacy-first AI infrastructure layer designed for engineering teams. It sits between your product code and LLM providers (OpenAI, Anthropic, etc.), giving you full control over prompts, costs, and observability without sending data to third-party SaaS loggers.\n\n\u003e **Status:** 🚧 **Active Development (v1 Alpha)**. Not ready for production yet.\n\n## 🏗 Architecture\n\nPromtix allows you to manage prompts in a user-friendly UI while serving them through a high-performance, stateless proxy.\n\n- **Control Plane (`apps/backend`):** Management API. Handles Users, Workspaces, Projects, and Prompt definitions.\n- **Data Plane (`apps/proxy`):** High-performance Gateway. Handles auth via Opaque Keys, resolves prompt context, and streams responses from LLMs.\n- **Admin Dashboard (apps/front):** Single Page Application (SPA). The UI for managing your workspaces, prompts, and viewing analytics.\n\n\u003e **Monorepo:** Organized using pnpm workspaces for efficient dependency management and code sharing.\n\n### Data Model\n\nWe use a **Workspace-First** hierarchy to organize resources:\n`Workspace (Billing/Team) -\u003e Project (Isolation) -\u003e Resources (Prompts, Keys, Environments)`\n\n## ⚡ Tech Stack\n\n- **Runtime:** Node.js / Docker\n- **Framework:** Hono\n- **Database:** PostgreSQL + Drizzle ORM\n- **Caching:** Redis (Context \u0026 Config Caching)\n- **Frontend:** React + Vite + TailwindCSS\n- **Package Manager:** pnpm (Workspaces)\n\n## 🛠 Features Roadmap\n\n### Phase 1: Foundation (Current)\n\n- [x] **Monorepo Setup:** Split-service architecture (Core + Proxy).\n- [x] **IAM System:** Multi-tenancy support via Workspaces \u0026 Projects.\n- [x] **Auth:** JWT for Admin UI, Opaque Scoped Keys for API Proxy.\n- [ ] **Prompt CMS:** Versioned prompts with support for `prod/dev/stage` environments.\n- [ ] **Universal Proxy:** OpenAI-compatible endpoint with context injection.\n\n### Phase 2: Observability \u0026 Control\n\n- [ ] **Request Logging:** Async logging to Postgres via Redis Queue.\n- [ ] **Analytics:** Token usage, Cost tracking, and Latency aggregation per Project/Prompt.\n- [ ] **Provider Management:** Encrypted storage for OpenAI/Anthropic API keys.\n\n### Phase 3: Advanced (Future)\n\n- [ ] **Shadow Testing:** Silent traffic splitting for prompt evaluation.\n- [ ] **Semantic Caching:** `pgvector` integration to reduce LLM costs.\n- [ ] **Experiments:** A/B testing for prompt variations.\n\n---\n\n## 🚀 Getting Started (Dev)\n\nPromtix is designed to be deployed via Docker (Coolify / Portainer).\n\n```bash\n# Clone repository\ngit clone https://github.com/ivan-yuldashev/promtix.git\ncd promtix\n\n# Install dependencies\npnpm install\n\n# Start infrastructure (Postgres + Redis)\ndocker-compose up -d postgres redis\n\n# Run migrations\npnpm db:push\n\n# Start development server\npnpm dev\n\n```\n\n---\n\n## 💬 Community \u0026 Support\n\nWe are building Promtix for the community, but we also run it in production. Here is how you can get help:\n\n- **🐛 Bug Reports:** Found a bug? Please [open an issue](https://github.com/ivan-yuldashev/promtix/issues).\n- **💡 Feature Requests:** Have an idea? Start a [discussion](https://github.com/ivan-yuldashev/promtix/discussions).\n- **❓ General Help:** Stuck on setup? Ask in [GitHub Discussions](https://github.com/ivan-yuldashev/promtix/discussions).\n- **💼 Commercial Support:** Need a managed version, SLA, or custom integration? Email us at `geekk@ya.ru`.\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see [CONTRIBUTING.md](https://www.google.com/search?q=CONTRIBUTING.md) for details.\n\n## ❤️ Sponsors\n\nPromtix is an open-source project maintained by Ivan Yuldashev.\nIf this tool saves you time or money in production, consider sponsoring the development to ensure its longevity.\n\n### Why sponsor?\n\n- **Prioritized Issues:** Sponsors get priority attention on bug reports.\n- **Badge:** Show your support on your GitHub profile.\n- **Sustainable Open Source:** Help cover infrastructure costs (hosting, domains, test runners).\n\n_Corporate sponsorships with logo placement are available. Contact us for details._\n\n## License\n\nThis project is licensed under the **GNU AGPL v3**.\n\n- **You can** use this locally or internally in your company for free.\n- **You can** modify the code.\n- **If you provide this as a service (SaaS)** to others over a network, you must open-source your modifications.\n\nSee [LICENSE](https://www.google.com/search?q=./LICENSE) for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fivan-yuldashev%2Fpromtix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fivan-yuldashev%2Fpromtix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fivan-yuldashev%2Fpromtix/lists"}