{"id":35794228,"url":"https://github.com/polarbase-team/polarbase","last_synced_at":"2026-03-08T16:12:30.050Z","repository":{"id":329938298,"uuid":"1092808436","full_name":"polarbase-team/polarbase","owner":"polarbase-team","description":"Extensible Open-source Data Backend for PostgreSQL. Features a multi-view UI (Spreadsheet, Dashboard, Calendar), AI-Agent integration via MCP, and zero vendor lock-in.","archived":false,"fork":false,"pushed_at":"2026-02-25T05:05:33.000Z","size":31576,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-25T09:36:08.171Z","etag":null,"topics":["ai-agents","angular","backend-as-a-service","bun","developer-tools","elysiajs","low-code","mcp-server","multi-view-ui","open-source","postgresql","realtime-database","spreadsheet","typescript"],"latest_commit_sha":null,"homepage":"https://polarbase-client.onrender.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/polarbase-team.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","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-11-09T11:04:31.000Z","updated_at":"2026-02-13T13:47:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/polarbase-team/polarbase","commit_stats":null,"previous_names":["polarbase-team/polarbase"],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/polarbase-team/polarbase","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/polarbase-team%2Fpolarbase","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/polarbase-team%2Fpolarbase/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/polarbase-team%2Fpolarbase/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/polarbase-team%2Fpolarbase/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/polarbase-team","download_url":"https://codeload.github.com/polarbase-team/polarbase/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/polarbase-team%2Fpolarbase/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30038546,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-03T06:58:30.252Z","status":"ssl_error","status_checked_at":"2026-03-03T06:58:15.329Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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-agents","angular","backend-as-a-service","bun","developer-tools","elysiajs","low-code","mcp-server","multi-view-ui","open-source","postgresql","realtime-database","spreadsheet","typescript"],"created_at":"2026-01-07T09:21:11.032Z","updated_at":"2026-03-03T08:56:13.963Z","avatar_url":"https://github.com/polarbase-team.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n   \u003cimg src=\"assets/logo.png\" width=\"150\" height=\"150\" alt=\"PolarBase\"\u003e\n   \u003cbr\u003e\n   \u003cb\u003ePolarBase\u003c/b\u003e\n   \u003cdiv align=\"center\"\u003e✨ ✨ ✨\u003c/div\u003e\n   \u003cspan\u003eOpen-source Extensible Data Backend\u003c/span\u003e \u003cbr\u003e\n   \u003cspan\u003eMulti-view UI • Agent-ready • Zero Lock-in • Postgre-native\u003c/span\u003e \u003cbr\u003e\n   \u003cbr\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[![GitHub stars](https://img.shields.io/github/stars/polarbase-team/polarbase?style=social)](https://github.com/polarbase-team/polarbase/stargazers)\n[![GitHub license](https://img.shields.io/github/license/polarbase-team/polarbase)](https://github.com/polarbase-team/polarbase/blob/main/LICENSE)\n\n\u003c/div\u003e\n\n## 1. Introduction\n\n**Polarbase** is an open-source **Extensible Data Backend** built directly on the PostgreSQL core. It empowers developers to architect, manage, and scale complex databases with ease, combining enterprise-grade reliability with a modern, developer-centric experience.\n\n**Architect your database with an intuitive UI and deploy data-driven solutions in minutes.**\u003cbr\u003e\n[Explore Demo](https://polarbase-client.onrender.com) • [View Roadmap](./ROADMAP.md) • [Changelog](./CHANGELOG.md)\n\n---\n\n### Why Polarbase?\n\n- **Multi-View Workspace:** Go beyond standard tables. **Structure** your data through specialized interfaces—**Spreadsheet** for rapid editing, **Dashboards** for real-time insights, and **Operational Views** (Forms/Calendars/Maps) for seamless workflows.\n- **Built for Extensibility:** Designed as a core foundation, not a closed silo. With upcoming **SDKs** and native **MCP (Model Context Protocol)** support, Polarbase is engineered to power both custom frontends and autonomous AI Agents.\n- **Pure PostgreSQL, Zero Lock-in:** We respect your data. By using SQLite exclusively for metadata, your PostgreSQL database remains clean, independent, and free from platform-specific overhead.\n- **Developer-Centric \u0026 Agile:** Optimized for **data-intensive applications** that demand high performance and minimal backend overhead without sacrificing the power of a professional-grade engine.\n\n---\n\n\u003e **Polarbase is currently in Public Beta.** \u003e We are actively building the future of extensible backends. Please **Star** and **Watch** the repo for updates!\n\n## 2. Screenshots\n\n\u003ctable width=\"100%\"\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"50%\" align=\"center\"\u003e\n      \u003cb\u003eSpreadsheet UI (Data View)\u003c/b\u003e\u003cbr\u003e\n      \u003cimg src=\"./assets/screenshots/1.png\" width=\"100%\"\u003e\n    \u003c/td\u003e\n    \u003ctd width=\"50%\" align=\"center\"\u003e\n      \u003cb\u003eCalendar View\u003c/b\u003e\u003cbr\u003e\n      \u003cimg src=\"./assets/screenshots/2.png\" width=\"100%\"\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003cb\u003eMap View\u003c/b\u003e\u003cbr\u003e\n      \u003cimg src=\"./assets/screenshots/3.png\" width=\"100%\"\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003cb\u003eAI Agent Interface\u003c/b\u003e\u003cbr\u003e\n      \u003cimg src=\"./assets/screenshots/4.png\" width=\"100%\"\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003cb\u003eDiversity of Data Types\u003c/b\u003e\u003cbr\u003e\n      \u003cimg src=\"./assets/screenshots/5.png\" width=\"100%\"\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003cb\u003eAPI Keys Management\u003c/b\u003e\u003cbr\u003e\n      \u003cimg src=\"./assets/screenshots/6.png\" width=\"100%\"\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## 3. Key Features\n\n- **REST API for DB**: Secure and efficient API endpoints to interact with your PostgreSQL database.\n- **AI Agent for DB**: Intelligent agent to assist with database operations. Focuses on data reasoning and operational assistance.\n- **MCP Server for DB**: Model Context Protocol server for streamlined administration.\n- **Realtime for DB**: Real-time updates and synchronization for dynamic data handling (via WebSocket or SSE).\n- **Multi-View**: User-friendly spreadsheet-style interface for data visualization and manipulation, besides calendar, map views, etc.\n- **API Key Management**: Generate API keys to grant controlled access to key features.\n\n## 4. Tech Stack\n\n- **Database**: PostgreSQL (\u003e= 14.0)\n- **Runtime**: Bun (\u003e= 1.0)\n- **Backend Framework**: Elysia (\u003e= 1.0)\n- **Frontend Framework**: Angular (\u003e= 17.0)\n- **AI Integration**: Google Gemini (default) or OpenAI\n- **Languages**: TypeScript (\u003e= 5.0), HTML, SCSS\n\n## 5. Getting Started\n\n### Cloud Version (Quick Try)\n\nVisit our [hosted demo](https://polarbase-client.onrender.com) to explore without installation.\n\n### Install Bun\n\nBun is a fast all-in-one JavaScript runtime that significantly outperforms Node.js in startup time, HTTP throughput, and package installation—often 2-4x faster (see benchmarks: [Bun.sh](https://bun.sh), [Strapi comparison](https://strapi.io/blog/bun-vs-nodejs-performance-comparison-guide), and [Better Stack guide](https://betterstack.com/community/guides/scaling-nodejs/nodejs-vs-deno-vs-bun/)).\n\nInstall it quickly by following the official instructions: [https://bun.sh/docs/installation](https://bun.sh/docs/installation)\n\n### Local Development\n\n1. Clone the repository:\n\n   ```bash\n   git clone https://github.com/polarbase-team/polarbase.git\n   cd polarbase\n   ```\n\n2. Install dependencies using Bun:\n\n   ```bash\n   bun install\n   ```\n\n3. Copy the example environment file:\n\n   ```bash\n   cp server/.env.example server/.env\n   ```\n\n   Then edit `server/.env` to add your configuration (API keys, database credentials, etc.).\n\n4. Run the development servers:\n   - Both server and client from root:\n     ```bash\n     bun start\n     ```\n   - Or separately:\n     - Server (backend):\n       ```bash\n       cd server\n       bun run dev\n       ```\n       Runs on `http://localhost:3000`\n     - Client (frontend):\n       ```bash\n       cd client\n       bun start\n       ```\n       Runs on `http://localhost:4200`\n\n   Access the app at `http://localhost:4200` (frontend).\n\n### Build for Production\n\n```bash\nbun run build\n```\n\n### Docker Support\n\nDeploy easily with Docker Compose (recommended for production):\n\n```bash\ndocker compose up --build\n```\n\n- Access at `http://localhost`.\n- Customize with environment variables in `docker-compose.yml`.\n\nFor a custom setup:\n\n```bash\ndocker run -e GEMINI_API_KEY=\u003cYOUR_GEMINI_KEY\u003e -p 3000:3000 polarbase-team/polarbase:latest\n```\n\n## 6. Configuration\n\n- **API Keys for AI**: Polarbase supports multiple AI providers (Gemini, OpenAI, Anthropic, xAI). Add your keys (e.g., `GEMINI_API_KEY=your_key`) to the `.env` file in the `server` folder.\n- **Local Models (LM Studio)**: Run models locally using [LM Studio](https://lmstudio.ai/):\n  1. Install LM Studio and download your preferred model.\n  2. Start the **Local Server** in LM Studio (default port: `1234`).\n  3. Polarbase defaults to `http://localhost:1234/v1`. Customize via `LOCAL_LLM_BASE_URL` in `.env` if needed.\n  4. In the Polarbase UI, open the Chatbot and select **Local** from the model menu.\n- **PostgreSQL Connection**: Configured in the `server/.env` file. Set your `POSTGRES_HOST`, `POSTGRES_USER`, `POSTGRES_PASSWORD`, etc., to match your database setup.\n- **Super Admin Key**: Use the super admin key for initial login and administration. Generate or set it in the `.env` file as `SUPER_ADMIN_API_KEY=your_secure_key_here`. This key is required to access admin features and manage API keys.\n- **API Key Generation**: Once logged in as super admin, generate API keys via the interface to control access to features like REST API or AI agent.\n\n**Privacy Note**: Polarbase does not store your database credentials. All operations run locally or in your controlled environment.\n\n## 7. Try It Out\n\n1. Go to the [app](https://polarbase-client.onrender.com).\n2. Connect your PostgreSQL database.\n3. Use the REST API or AI agent for operations.\n4. Explore realtime features and spreadsheet-UI for data management.\n5. Generate API keys to manage access.\n\n## 8. Libraries \u0026 Technologies Used\n\n- **Knexjs**: For type-safe database querying and migrations.\n- **ai-sdk**: Integration for AI agents and providers (Gemini, OpenAI).\n- **fastmcp**: Efficient implementation of the Model Context Protocol server.\n- **PrimeNG**: Rich set of UI components for Angular.\n- **Tailwind CSS**: Utility-first CSS framework for rapid styling.\n- **Leaflet**: Open-source JavaScript library for mobile-friendly interactive maps.\n- **FullCalendar**: The most popular JavaScript Calendar.\n- Other dependencies: WebSocket libraries for realtime updates, Angular modules for frontend, and more (see `package.json` files in `client` and `server` for the full list).\n\n## 9. Community \u0026 Support\n\n- **[GitHub Issues](https://github.com/polarbase-team/polarbase/issues)**: Report bugs or request features.\n\n## 10. Contributing\n\nWe welcome contributions! Whether it's fixing bugs, adding features, or improving docs.\n\n- See our [Contributing Guide](./CONTRIBUTING.md) for details.\n- Follow the [Code of Conduct](./CODE_OF_CONDUCT.md).\n\nFork the repo, create a branch, and submit a Pull Request—we'll review it ASAP.\n\n## 11. License\n\nPolarbase is licensed under the [MIT License](./LICENSE).\n\n---\n\nMade with ❤️ by the **polarbase-team**.  \nIf you like the project, give it a ⭐ on GitHub! 😊\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpolarbase-team%2Fpolarbase","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpolarbase-team%2Fpolarbase","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpolarbase-team%2Fpolarbase/lists"}