{"id":41932763,"url":"https://github.com/0xerwin1/dbflux","last_synced_at":"2026-05-17T02:49:22.276Z","repository":{"id":334036858,"uuid":"1125356218","full_name":"0xErwin1/dbflux","owner":"0xErwin1","description":"A fast, keyboard-first database client built with Rust and GPUI.","archived":false,"fork":false,"pushed_at":"2026-03-28T11:00:40.000Z","size":4225,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-28T21:23:31.048Z","etag":null,"topics":["cross-platform","database","database-client","db","developer-tools","gpui","mongodb","mysql","nosql","postgresql","query-editor","redis","rust","sql"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/0xErwin1.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE-APACHE","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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-12-30T15:26:23.000Z","updated_at":"2026-03-07T00:04:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/0xErwin1/dbflux","commit_stats":null,"previous_names":["0xerwin1/dbflux"],"tags_count":24,"template":false,"template_full_name":null,"purl":"pkg:github/0xErwin1/dbflux","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xErwin1%2Fdbflux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xErwin1%2Fdbflux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xErwin1%2Fdbflux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xErwin1%2Fdbflux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0xErwin1","download_url":"https://codeload.github.com/0xErwin1/dbflux/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xErwin1%2Fdbflux/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31311010,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":["cross-platform","database","database-client","db","developer-tools","gpui","mongodb","mysql","nosql","postgresql","query-editor","redis","rust","sql"],"created_at":"2026-01-25T18:02:45.817Z","updated_at":"2026-05-17T02:49:22.251Z","avatar_url":"https://github.com/0xErwin1.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DBFlux\n\nA fast, keyboard-first database client built with Rust and GPUI.\n\n## Overview\n\nDBFlux is an open-source database client written in Rust, built with GPUI (Zed's UI framework). It focuses on performance, a clean UX, and keyboard-first workflows.\n\nThe long-term goal is to provide a fully open-source alternative to DBeaver, supporting both relational and non-relational databases.\n\n![DBFlux](resources/dbflux.png)\n\n## Documentation\n\n- [Architecture](ARCHITECTURE.md)\n- [Contributing](CONTRIBUTING.md)\n- [Release Process](docs/RELEASE.md)\n- [Code Style](CODE_STYLE.md)\n- [Agent Instructions](AGENTS.md)\n- [Claude Instructions](CLAUDE.md)\n- [Audit](docs/AUDIT.md)\n- [AI + MCP Integration Guide](docs/MCP_AI_INTEGRATION.md)\n- [Driver RPC Protocol](docs/DRIVER_RPC_PROTOCOL.md)\n- [RPC Services Config](docs/RPC_SERVICES_CONFIG.md)\n- [Lua Scripting](docs/LUA.md)\n\n## Installation\n\n### Linux\n\n#### Tarball (recommended)\n\n```bash\n# Install to /usr/local (requires sudo)\ncurl -fsSL https://raw.githubusercontent.com/0xErwin1/dbflux/main/scripts/install.sh | sudo bash\n\n# Install to ~/.local (no sudo required)\ncurl -fsSL https://raw.githubusercontent.com/0xErwin1/dbflux/main/scripts/install.sh | bash -s -- --prefix ~/.local\n```\n\n#### AppImage (portable)\n\n```bash\n# Download from releases (replace amd64 with arm64 for ARM)\nwget https://github.com/0xErwin1/dbflux/releases/latest/download/dbflux-linux-amd64.AppImage\nchmod +x dbflux-linux-amd64.AppImage\n./dbflux-linux-amd64.AppImage\n```\n\n#### Arch Linux\n\nAvailable in the AUR:\n\n```bash\n# Using an AUR helper\nparu -S dbflux\n# or\nyay -S dbflux\n```\n\n#### Debian / Ubuntu\n\nDownload the `.deb` package from [Releases](https://github.com/0xErwin1/dbflux/releases):\n\n```bash\n# Replace amd64 with arm64 for ARM\nwget https://github.com/0xErwin1/dbflux/releases/latest/download/dbflux-linux-amd64.deb\nsudo dpkg -i dbflux-linux-amd64.deb\n```\n\n#### Fedora / RHEL / CentOS\n\nDownload the `.rpm` package from [Releases](https://github.com/0xErwin1/dbflux/releases):\n\n```bash\n# Replace amd64 with arm64 for ARM\nsudo dnf install https://github.com/0xErwin1/dbflux/releases/latest/download/dbflux-linux-amd64.rpm\n```\n\n#### Nix\n\nUsing flakes (the default package is a **prebuilt binary** for Linux x86_64 / aarch64, no compilation):\n\n```bash\n# Run directly (prebuilt)\nnix run github:0xErwin1/dbflux\n\n# Install to profile (prebuilt)\nnix profile install github:0xErwin1/dbflux\n\n# Development shell\nnix develop github:0xErwin1/dbflux\n```\n\nBuild from source instead of using the prebuilt binary:\n\n```bash\nnix run    github:0xErwin1/dbflux#dbflux-source\nnix build  github:0xErwin1/dbflux#dbflux-source\n```\n\nNixOS / nix-darwin via overlay:\n\n```nix\n{\n  inputs.dbflux.url = \"github:0xErwin1/dbflux\";\n\n  outputs = { nixpkgs, dbflux, ... }: {\n    nixosConfigurations.myhost = nixpkgs.lib.nixosSystem {\n      modules = [\n        ({ pkgs, ... }: {\n          nixpkgs.overlays = [ dbflux.overlays.default ];\n          environment.systemPackages = [\n            pkgs.dbflux         # prebuilt binary, no local compile\n            # pkgs.dbflux-source  # alternative: build from source\n          ];\n        })\n      ];\n    };\n  };\n}\n```\n\n### macOS\n\nDBFlux for macOS is not signed with an Apple developer certificate. When opening for the first time, you'll see a warning about an \"unidentified developer\".\n\n#### Installation\n\n1. Download the DMG for your architecture from [Releases](https://github.com/0xErwin1/dbflux/releases):\n   - **Intel Macs**: `dbflux-macos-amd64.dmg`\n   - **Apple Silicon (M1/M2/M3/M4)**: `dbflux-macos-arm64.dmg`\n2. Open the DMG and drag DBFlux to Applications\n3. When you see the \"unidentified developer\" warning:\n   - Go to **System Settings → Privacy \u0026 Security**\n   - Click **Open Anyway** next to the security warning\n   - Confirm you want to open the application\n\n#### Bypass Gatekeeper from Terminal\n\n```bash\n# Remove quarantine attribute (allows opening without GUI confirmation)\nxattr -cr /Applications/DBFlux.app\n\n# Now you can open it normally\nopen /Applications/DBFlux.app\n```\n\n#### Requirements\n\n- macOS 11.0 (Big Sur) or later\n\n### Windows\n\n#### Installer\n\n1. Download `dbflux-windows-amd64-setup.exe` from [Releases](https://github.com/0xErwin1/dbflux/releases)\n2. Run the installer and follow the wizard\n\n#### Portable\n\n1. Download `dbflux-windows-amd64.zip` from [Releases](https://github.com/0xErwin1/dbflux/releases)\n2. Extract to any folder\n3. Run `dbflux.exe`\n\n\u003e **Note**: The executable is not signed with a Windows code signing certificate. Windows SmartScreen may show a warning. Click \"More info\" → \"Run anyway\" to proceed.\n\n#### Requirements\n\n- Windows 10 or later\n- x86_64 (ARM64 not yet supported)\n\n### Build from Source\n\n```bash\n# Via install script (Linux)\ncurl -fsSL https://raw.githubusercontent.com/0xErwin1/dbflux/main/scripts/install.sh | bash -s -- --build\n\n# Or manually\ngit clone https://github.com/0xErwin1/dbflux.git\ncd dbflux\n\n# Recommended: build with the full default feature set\ncargo build --release --features sqlite,postgres,mysql,mongodb,redis,dynamodb,cloudwatch,influxdb,lua,aws,mcp\n\n# Minimal build (relational drivers only, no AI/MCP, no Lua)\ncargo build --release --no-default-features --features sqlite,postgres,mysql\n\n./target/release/dbflux\n```\n\n### Uninstall (Linux)\n\n```bash\n# If installed with install.sh\ncurl -fsSL https://raw.githubusercontent.com/0xErwin1/dbflux/main/scripts/uninstall.sh | sudo bash\n\n# From ~/.local\ncurl -fsSL https://raw.githubusercontent.com/0xErwin1/dbflux/main/scripts/uninstall.sh | bash -s -- --prefix ~/.local\n\n# Remove user config and data too\n./scripts/uninstall.sh --remove-config\n```\n## Features\n\n### Database Support\n\n- **PostgreSQL** with SSL/TLS modes (Disable, Prefer, Require)\n- **MySQL** / MariaDB\n- **SQLite** for local database files\n- **MongoDB** with collection browsing, document CRUD, and shell query generation\n- **Redis** with key browsing for all types (String, Hash, List, Set, Sorted Set, Stream)\n- **DynamoDB** with table browsing, item CRUD, and AWS authentication\n- **CloudWatch Logs** with log group/stream browsing and event streaming\n- SSH tunnel support with key, password, and agent authentication\n- Reusable SSH tunnel profiles\n\n### User Interface\n\n- Document-based workspace with multiple result tabs (like DBeaver/VS Code)\n- Collapsible, resizable sidebar with ToggleSidebar command (Ctrl+B)\n- Schema tree browser with lazy loading for large databases\n- Schema-level metadata: indexes, foreign keys, constraints, custom types (PostgreSQL)\n- Multi-tab SQL editor with syntax highlighting\n- Virtualized data table with column resizing, horizontal scrolling, and sorting\n- Table browser with WHERE filters, custom LIMIT, and pagination\n- \"Copy as Query\" context menu to copy INSERT/UPDATE/DELETE as SQL, MongoDB shell, or Redis commands\n- Query preview modal with language-specific syntax highlighting\n- Command palette with fuzzy search\n- Custom toast notification system with auto-dismiss\n- Background task panel\n\n### Keyboard Navigation\n\n- Vim-style navigation (`j`/`k`/`h`/`l`) throughout the app\n- Context-aware keybindings (Document, Sidebar, BackgroundTasks)\n- Document focus with internal editor/results navigation\n- Results toolbar: `f` to focus, `h`/`l` to navigate, `Enter` to edit/execute, `Esc` to exit\n- Toggle sidebar with `Ctrl+B`\n- Tab switching (MRU order) with `Ctrl+Tab` / `Ctrl+Shift+Tab`\n\n### Query Management\n\n- Query history with timestamps\n- Saved queries with favorites\n- Search across history and saved queries\n\n### Export\n\n- Shape-based export: CSV, JSON (pretty/compact), Text, Binary (raw/hex/base64)\n- Export format determined by result type (table, JSON, text, binary)\n\n## Development\n\n### Prerequisites\n\n**Ubuntu/Debian:**\n```bash\nsudo apt install pkg-config libssl-dev libdbus-1-dev libxkbcommon-dev\n```\n\n**Fedora:**\n```bash\nsudo dnf install pkg-config openssl-devel dbus-devel libxkbcommon-devel\n```\n\n**Arch:**\n```bash\nsudo pacman -S pkg-config openssl dbus libxkbcommon\n```\n\n**macOS:**\n```bash\n# Xcode Command Line Tools (required)\nxcode-select --install\n```\n\n**Windows:**\n```powershell\n# Visual Studio Build Tools with C++ workload (required)\n# Download from: https://visualstudio.microsoft.com/visual-cpp-build-tools/\n```\n\n### Building\n\n```bash\ncargo build -p dbflux --release\n```\n\n### Running\n\n```bash\ncargo run -p dbflux\n```\n\n### Commands\n\n```bash\ncargo check --workspace                    # Type checking\ncargo clippy --workspace -- -D warnings    # Lint\ncargo fmt --all                            # Format\ncargo test --workspace                     # Tests\n```\n\n### Nix Development Shell\n\nIf you use Nix, you can enter a development shell with all dependencies:\n\n```bash\n# With flakes\nnix develop\n\n# Traditional\nnix-shell\n```\n\n## License\n\nMIT \u0026 Apache-2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xerwin1%2Fdbflux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0xerwin1%2Fdbflux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xerwin1%2Fdbflux/lists"}