{"id":50470529,"url":"https://github.com/hitoshyamamoto/hayai","last_synced_at":"2026-06-01T10:03:07.617Z","repository":{"id":303338070,"uuid":"1015126478","full_name":"hitoshyamamoto/hayai","owner":"hitoshyamamoto","description":"Instantly create and manage local SQL, NoSQL, and Vector databases with Docker using a fast and extensible CLI tool for backend developers.","archived":false,"fork":false,"pushed_at":"2025-07-09T05:17:20.000Z","size":1903,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-10-11T16:08:03.888Z","etag":null,"topics":["backend","cli","database","database-management","developer-tools"],"latest_commit_sha":null,"homepage":"","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/hitoshyamamoto.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}},"created_at":"2025-07-07T03:41:06.000Z","updated_at":"2025-07-13T11:36:35.000Z","dependencies_parsed_at":"2025-07-07T05:28:40.771Z","dependency_job_id":"db534d4a-4a26-4605-a863-485b27cab17c","html_url":"https://github.com/hitoshyamamoto/hayai","commit_stats":null,"previous_names":["hitoshyamamoto/haya"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hitoshyamamoto/hayai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hitoshyamamoto%2Fhayai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hitoshyamamoto%2Fhayai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hitoshyamamoto%2Fhayai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hitoshyamamoto%2Fhayai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hitoshyamamoto","download_url":"https://codeload.github.com/hitoshyamamoto/hayai/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hitoshyamamoto%2Fhayai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33769492,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-01T02:00:06.963Z","response_time":115,"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":["backend","cli","database","database-management","developer-tools"],"created_at":"2026-06-01T10:03:06.287Z","updated_at":"2026-06-01T10:03:07.609Z","avatar_url":"https://github.com/hitoshyamamoto.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\r\n  \u003cimg src=\"assets/logo_hayai.png\" alt=\"Hayai Logo\" width=\"200\"/\u003e\r\n  \u003ch1\u003eHayai ⚡\u003c/h1\u003e\r\n  \u003cp\u003e\u003cem\u003eInstantly create and manage local databases with one command\u003c/em\u003e\u003c/p\u003e\r\n  \r\n  ![GitHub Actions](https://github.com/hitoshyamamoto/hayai/workflows/CI/badge.svg)\r\n  ![npm version](https://img.shields.io/npm/v/hayai-db.svg)\r\n  ![License](https://img.shields.io/badge/license-MIT-blue.svg)\r\n  ![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)\r\n  \r\n  ![npm downloads](https://img.shields.io/npm/dw/hayai-db.svg)\r\n  ![GitHub stars](https://img.shields.io/github/stars/hitoshyamamoto/hayai.svg?style=social)\r\n  ![GitHub forks](https://img.shields.io/github/forks/hitoshyamamoto/hayai.svg?style=social)\r\n  \r\n  ![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?logo=typescript\u0026logoColor=white)\r\n  ![Docker](https://img.shields.io/badge/Docker-2496ED?logo=docker\u0026logoColor=white)\r\n  ![Databases](https://img.shields.io/badge/Databases-19-success)\r\n  ![CLI](https://img.shields.io/badge/CLI-Tool-blue)\r\n  \r\n  ![Security](https://img.shields.io/badge/Security-0%20vulnerabilities-brightgreen)\r\n  ![Platform](https://img.shields.io/badge/Platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey)\r\n  ![Maintenance](https://img.shields.io/badge/Maintained-Yes-brightgreen)\r\n\u003c/div\u003e\r\n\r\n\u003cbr\u003e\r\n\r\n## 🇯🇵 About the Name\r\n\r\n**Hayai** (速い) means \"fast\" or \"quick\" in Japanese. This CLI tool lives up to its name by instantly creating and managing local databases with a single command.\r\n\r\n## 🚀 What is Hayai?\r\n\r\nFast, modern CLI tool for managing local SQL and NoSQL databases with Docker. Built for backend developers who need quick database instances for development and testing.\r\n\r\n**Perfect for:**\r\n- 🏗️ **Local Development** - Spin up databases instantly\r\n- 🧪 **Testing Environments** - Isolated database instances\r\n- 🔬 **Experimentation** - Try different databases quickly\r\n- 📚 **Learning** - Explore various database technologies\r\n\r\n## 🌟 Support \u0026 Community\r\n\r\nIf you find Hayai useful, please consider giving us a ⭐ **Star** on GitHub! It helps us understand that people are using and appreciating the project, and motivates us to keep improving it.\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n  \u003ca href=\"https://github.com/hitoshyamamoto/hayai\"\u003e\r\n    \u003cimg src=\"https://img.shields.io/github/stars/hitoshyamamoto/hayai?style=social\" alt=\"GitHub stars\"\u003e\r\n  \u003c/a\u003e\r\n  \u003ca href=\"https://github.com/hitoshyamamoto/hayai/fork\"\u003e\r\n    \u003cimg src=\"https://img.shields.io/github/forks/hitoshyamamoto/hayai?style=social\" alt=\"GitHub forks\"\u003e\r\n  \u003c/a\u003e\r\n\u003c/div\u003e\r\n\r\n### 💬 Get Involved\r\n\r\nWe're building Hayai to be the best database management tool for developers, and your input matters:\r\n\r\n- **🐛 Found a bug?** Report it in our [Issues](https://github.com/hitoshyamamoto/hayai/issues) section\r\n- **💡 Have an idea?** Share it in [Discussions](https://github.com/hitoshyamamoto/hayai/discussions)\r\n- **🚀 Want a new database?** Request it through [Feature Requests](https://github.com/hitoshyamamoto/hayai/issues/new?template=feature_request.md)\r\n- **📖 Need help?** Ask questions in [Discussions](https://github.com/hitoshyamamoto/hayai/discussions/categories/q-a)\r\n\r\n### 🤝 Contributing\r\n\r\nHayai is open-source and welcomes contributions! Whether it's:\r\n- 🔧 Code improvements\r\n- 📝 Documentation updates  \r\n- 🐛 Bug reports\r\n- 💡 Feature suggestions\r\n- 🌐 Translations\r\n\r\nCheck out our [Contributing Guide](CONTRIBUTING.md) to get started!\r\n\r\n## ⚡ Quick Start\r\n\r\n```bash\r\n# Install globally\r\nnpm install -g hayai-db\r\n\r\n# Initialize a PostgreSQL database\r\nhayai init\r\n\r\n# Start all databases\r\nhayai start\r\n\r\n# Open admin dashboards\r\nhayai studio\r\n```\r\n\r\n## 🎯 Key Features\r\n\r\n- **🔓 100% Open-Source**: Only includes databases with permissive licenses\r\n- **⚡ One Command Setup**: Initialize any database with a single command\r\n- **🐳 Docker-Powered**: Automated container management with health checks\r\n- **🔧 Smart Port Management**: Intelligent port allocation (5000-6000 range)\r\n- **🌐 Admin Dashboards**: Built-in web interfaces for database management\r\n- **🔗 Environment Integration**: Automatic `.env` file updates with connection URIs\r\n- **✨ Modern CLI**: Interactive prompts with beautiful output\r\n\r\n## 📦 Supported Databases\r\n\r\nAll databases are **100% open-source** with permissive licenses:\r\n\r\n\u003cdetails\u003e\r\n\u003csummary\u003e\u003cstrong\u003eSQL Databases (2)\u003c/strong\u003e\u003c/summary\u003e\r\n\r\n- **PostgreSQL** (PostgreSQL License) - Most popular open-source relational database\r\n- **MariaDB** (GPL v2) - MySQL community fork with enhanced features\r\n\u003c/details\u003e\r\n\r\n\u003cdetails\u003e\r\n\u003csummary\u003e\u003cstrong\u003eAnalytics Databases (1)\u003c/strong\u003e\u003c/summary\u003e\r\n\r\n- **DuckDB** (MIT) - Analytics-focused columnar SQL database for OLAP workloads\r\n\u003c/details\u003e\r\n\r\n\u003cdetails\u003e\r\n\u003csummary\u003e\u003cstrong\u003eEmbedded Databases (2)\u003c/strong\u003e\u003c/summary\u003e\r\n\r\n- **SQLite** (Public Domain) - Lightweight embedded SQL database\r\n- **LMDB** (OpenLDAP Public License) - Ultra-fast memory-mapped embedded key-value store\r\n\u003c/details\u003e\r\n\r\n\u003cdetails\u003e\r\n\u003csummary\u003e\u003cstrong\u003eKey-Value Databases (3)\u003c/strong\u003e\u003c/summary\u003e\r\n\r\n- **Redis** (BSD 3-Clause) - High-performance in-memory key-value store\r\n- **LevelDB** (BSD) - High-performance embedded key-value storage library\r\n- **TiKV** (Apache 2.0) - CNCF graduated distributed transactional key-value store\r\n\u003c/details\u003e\r\n\r\n\u003cdetails\u003e\r\n\u003csummary\u003e\u003cstrong\u003eWide Column Databases (1)\u003c/strong\u003e\u003c/summary\u003e\r\n\r\n- **Apache Cassandra** (Apache 2.0) - Distributed wide column store\r\n\u003c/details\u003e\r\n\r\n\u003cdetails\u003e\r\n\u003csummary\u003e\u003cstrong\u003eVector Databases (3)\u003c/strong\u003e\u003c/summary\u003e\r\n\r\n- **Qdrant** (Apache 2.0) - Vector database with REST API\r\n- **Weaviate** (BSD 3-Clause) - Vector search engine with ML models\r\n- **Milvus** (Apache 2.0) - Vector database for AI applications\r\n\u003c/details\u003e\r\n\r\n\u003cdetails\u003e\r\n\u003csummary\u003e\u003cstrong\u003eGraph Databases (2)\u003c/strong\u003e\u003c/summary\u003e\r\n\r\n- **ArangoDB** (Apache 2.0) - Multi-model database (graph, document, key-value)\r\n- **NebulaGraph** (Apache 2.0) - Distributed graph database with millisecond latency\r\n\u003c/details\u003e\r\n\r\n\u003cdetails\u003e\r\n\u003csummary\u003e\u003cstrong\u003eSearch Databases (2)\u003c/strong\u003e\u003c/summary\u003e\r\n\r\n- **Meilisearch** (MIT) - Modern full-text search engine\r\n- **Typesense** (GPL v3) - Fast, typo-tolerant search engine\r\n\u003c/details\u003e\r\n\r\n\u003cdetails\u003e\r\n\u003csummary\u003e\u003cstrong\u003eTime Series Databases (6)\u003c/strong\u003e\u003c/summary\u003e\r\n\r\n- **InfluxDB 2.x** (MIT) - Modern time series platform with full features\r\n- **InfluxDB 3 Core** (MIT/Apache 2.0) - Latest generation time series database\r\n- **TimescaleDB** (Timescale License) - PostgreSQL-based time series database\r\n- **QuestDB** (Apache 2.0) - High-performance time series with SQL support\r\n- **VictoriaMetrics** (Apache 2.0) - Prometheus-compatible metrics database\r\n- **Apache HoraeDB** (Apache 2.0) - Cloud-native distributed time series database\r\n\u003c/details\u003e\r\n\r\n**Total: 22 databases across 9 categories**\r\n\r\n## 🛠️ Installation\r\n\r\n### Prerequisites\r\n- **Node.js** 18.0.0 or higher\r\n- **Docker** and **Docker Compose**\r\n\r\n### Install Hayai\r\n```bash\r\nnpm install -g hayai-db\r\n```\r\n\r\n### Verify Installation\r\n```bash\r\nhayai --version\r\n```\r\n\r\n## 📋 Commands Reference\r\n\r\n### Core Commands\r\n\r\n| Command | Description | Example |\r\n|---------|-------------|---------|\r\n| `hayai init` | Initialize a new database instance | `hayai init -n mydb -e postgresql` |\r\n| `hayai start [name]` | Start database instances | `hayai start` or `hayai start mydb` |\r\n| `hayai stop [name]` | Stop database instances | `hayai stop` or `hayai stop mydb` |\r\n| `hayai list` | List all database instances | `hayai list --running` |\r\n| `hayai studio [name]` | Open admin dashboards | `hayai studio mydb` |\r\n\r\n### Configuration Commands\r\n\r\n| Command | Description | Example |\r\n|---------|-------------|---------|\r\n| `hayai init --config .hayaidb` | Initialize from configuration file | `hayai init --config .hayaidb` |\r\n| `hayai validate --config .hayaidb` | Validate configuration file | `hayai validate --config .hayaidb` |\r\n| `hayai config check` | Check configuration syntax | `hayai config check` |\r\n\r\n📚 **See [HAYAIDB.md](HAYAIDB.md) for complete configuration file documentation**\r\n\r\n### Management Commands\r\n\r\n| Command | Description | Example |\r\n|---------|-------------|---------|\r\n| `hayai remove \u003cname\u003e` | Remove database instance | `hayai remove mydb --force` |\r\n| `hayai logs \u003cname\u003e` | View database logs | `hayai logs mydb --follow` |\r\n| `hayai snapshot \u003cname\u003e` | Create database snapshot | `hayai snapshot mydb --compress` |\r\n| `hayai clone \u003coptions\u003e` | Clone database instances | `hayai clone --from prod --to staging` |\r\n| `hayai merge \u003coptions\u003e` | Merge two databases bidirectionally | `hayai merge --source dbA --target dbB --preview` |\r\n\r\n📸 **For complete backup and snapshot documentation, see: [ABOUT_BACKUP.md](ABOUT_BACKUP.md)**\r\n\r\n### Detailed Usage\r\n\r\n\u003cdetails\u003e\r\n\u003csummary\u003e\u003cstrong\u003ehayai init\u003c/strong\u003e - Initialize Database\u003c/summary\u003e\r\n\r\n```bash\r\n# Interactive mode\r\nhayai init\r\n\r\n# Quick setup\r\nhayai init -n mydb -e postgresql -p 5432 -y\r\n\r\n# With admin dashboard\r\nhayai init --admin-dashboard\r\n\r\n# Custom configuration\r\nhayai init -n cache -e redis -p 6379 --memory 512mb\r\n```\r\n\r\n**Options:**\r\n- `-n, --name \u003cname\u003e` - Database name\r\n- `-e, --engine \u003cengine\u003e` - Database engine\r\n- `-p, --port \u003cport\u003e` - Port number\r\n- `-y, --yes` - Skip confirmations\r\n- `--admin-dashboard` - Enable admin dashboard\r\n\u003c/details\u003e\r\n\r\n\u003cdetails\u003e\r\n\u003csummary\u003e\u003cstrong\u003ehayai start\u003c/strong\u003e - Start Databases\u003c/summary\u003e\r\n\r\n```bash\r\n# Start all databases\r\nhayai start\r\n\r\n# Start specific database\r\nhayai start mydb\r\n\r\n# Start with custom options\r\nhayai start --detach --timeout 60\r\n```\r\n\u003c/details\u003e\r\n\r\n\u003cdetails\u003e\r\n\u003csummary\u003e\u003cstrong\u003ehayai clone\u003c/strong\u003e - Clone Database Instances\u003c/summary\u003e\r\n\r\n```bash\r\n# Simple 1:1 clone\r\nhayai clone --from prod --to staging\r\nhayai clone -f prod -t staging -y\r\n\r\n# Clone to multiple databases (1:N)\r\nhayai clone --from prod --to-multiple \"test1,test2,test3\"\r\nhayai clone -f prod -tm \"dev,staging,qa\" -y\r\n\r\n# Preview clone without executing\r\nhayai clone -f prod -t staging --dry-run\r\n\r\n# Force overwrite existing databases\r\nhayai clone -f prod -t staging --force -y\r\n```\r\n\r\n**Options:**\r\n- `-f, --from \u003cname\u003e` - Source database name\r\n- `-t, --to \u003cname\u003e` - Target database name (1:1 clone)\r\n- `-tm, --to-multiple \u003cnames\u003e` - Target database names (comma-separated, 1:N clone)\r\n- `-y, --confirm` - Skip confirmation prompt\r\n- `--force` - Overwrite existing target databases\r\n- `--dry-run` - Show what would be cloned without executing\r\n\r\n**Supported Engines:** PostgreSQL, MariaDB, Redis, SQLite, DuckDB, and all other engines with generic data copying.\r\n\u003c/details\u003e\r\n\r\n\u003cdetails\u003e\r\n\u003csummary\u003e\u003cstrong\u003ehayai merge\u003c/strong\u003e - Merge Database Instances\u003c/summary\u003e\r\n\r\n```bash\r\n# Preview merge operation\r\nhayai merge --source dbA --target dbB --preview\r\nhayai merge -s dbA -t dbB --preview\r\n\r\n# Execute merge operation\r\nhayai merge --source dbA --target dbB --execute\r\nhayai merge -s dbA -t dbB --execute\r\n\r\n# Force merge without confirmation\r\nhayai merge -s dbA -t dbB --execute --force\r\n```\r\n\r\n**Options:**\r\n- `-s, --source \u003cname\u003e` - Source database name\r\n- `-t, --target \u003cname\u003e` - Target database name\r\n- `--preview` - Preview the merge operation without executing\r\n- `--execute` - Execute the merge operation\r\n- `--backup-both` - Create backups of both databases before merging\r\n- `--force` - Skip confirmation prompts\r\n\r\n**How Merge Works:**\r\n- Data from source is copied to target\r\n- Data from target is copied to source  \r\n- Both databases end up with combined data\r\n- Conflicts are resolved automatically when possible\r\n\r\n**Supported Engines:** PostgreSQL (SQL-level), MariaDB (SQL-level), Redis (key-level with REPLACE), others (generic file-based).\r\n\u003c/details\u003e\r\n\r\n\u003cdetails\u003e\r\n\u003csummary\u003e\u003cstrong\u003ehayai list\u003c/strong\u003e - List Databases\u003c/summary\u003e\r\n\r\n```bash\r\n# List all databases\r\nhayai list\r\n\r\n# Show only running databases\r\nhayai list --running\r\n\r\n# JSON output\r\nhayai list --format json\r\n\r\n# Detailed view\r\nhayai list --verbose\r\n```\r\n\u003c/details\u003e\r\n\r\n## 🔧 Configuration\r\n\r\nHayai uses a `hayai.config.yaml` file for global configuration:\r\n\r\n```yaml\r\nversion: '1.0.0'\r\ndocker:\r\n  network_name: hayai-network\r\n  compose_file: docker-compose.yml\r\n  data_directory: ./data\r\nlogging:\r\n  level: info\r\n  file: hayai.log\r\ndefaults:\r\n  port_range:\r\n    start: 5000\r\n    end: 6000\r\n  volume_driver: local\r\n  restart_policy: unless-stopped\r\n```\r\n\r\n## 📄 .hayaidb - Declarative Database Configuration\r\n\r\nThe `.hayaidb` file provides a **declarative approach** to database management, allowing you to define multiple databases with their configurations in a single file.\r\n\r\n### ✅ **Key Benefits**\r\n- **🔧 Centralized Configuration**: Define all databases in one place\r\n- **📋 Declarative Setup**: Specify what you want, not how to achieve it\r\n- **🔄 Reproducible Environments**: Share configurations across team members\r\n- **⚡ Batch Operations**: Initialize, start, or stop multiple databases at once\r\n\r\n### 🚀 **Quick Example**\r\n```yaml\r\nversion: \"1.0\"\r\nproject: my-app\r\ndatabases:\r\n  main-postgres:\r\n    engine: postgresql\r\n    port: 5432\r\n    environment:\r\n      POSTGRES_DB: myapp\r\n      POSTGRES_USER: admin\r\n      POSTGRES_PASSWORD: password\r\n  \r\n  cache-redis:\r\n    engine: redis\r\n    port: 6379\r\n    environment:\r\n      REDIS_PASSWORD: password\r\n  \r\n  metrics-influxdb2:\r\n    engine: influxdb2\r\n    port: 8086\r\n    environment:\r\n      DOCKER_INFLUXDB_INIT_USERNAME: admin\r\n      DOCKER_INFLUXDB_INIT_PASSWORD: password\r\n      DOCKER_INFLUXDB_INIT_ORG: myapp-org\r\n      DOCKER_INFLUXDB_INIT_BUCKET: metrics\r\n```\r\n\r\n### 🔧 **Usage**\r\n```bash\r\n# Initialize all databases from .hayaidb\r\nhayai init --config .hayaidb\r\n\r\n# Start all databases\r\nhayai start --config .hayaidb\r\n\r\n# Stop all databases\r\nhayai stop --config .hayaidb\r\n```\r\n\r\n📚 **For complete documentation and examples, see: [HAYAIDB.md](HAYAIDB.md)**\r\n\r\n## 📚 Usage Examples\r\n\r\n### Development Environment Setup\r\n\r\n```bash\r\n# Main database\r\nhayai init -n maindb -e postgresql -y\r\n\r\n# Caching layer\r\nhayai init -n cache -e redis -y\r\n\r\n# Search functionality\r\nhayai init -n search -e meilisearch -y\r\n\r\n# Start all services\r\nhayai start\r\n\r\n# Check status\r\nhayai list\r\n```\r\n\r\n### AI/ML Development Stack\r\n\r\n```bash\r\n# Vector database for embeddings\r\nhayai init -n vectors -e qdrant -y\r\n\r\n# Time series for metrics\r\nhayai init -n metrics -e influxdb3 -y\r\n\r\n# Traditional data storage\r\nhayai init -n data -e postgresql -y\r\n\r\n# Launch everything\r\nhayai start\r\nhayai studio  # Open all dashboards\r\n```\r\n\r\n### Microservices Testing\r\n\r\n```bash\r\n# User service database\r\nhayai init -n users -e postgresql -p 5432 -y\r\n\r\n# Session store\r\nhayai init -n sessions -e redis -p 6379 -y\r\n\r\n# Analytics database\r\nhayai init -n analytics -e questdb -p 9000 -y\r\n\r\n# Graph relationships\r\nhayai init -n graph -e arangodb -p 8529 -y\r\n```\r\n\r\n## 🌟 Why Choose Hayai?\r\n\r\n### 🎯 Developer Experience\r\n- **Interactive CLI** - Beautiful prompts with validation\r\n- **Smart Defaults** - Sensible configuration out of the box\r\n- **Error Handling** - Clear error messages and recovery suggestions\r\n- **Auto-completion** - Shell completion support\r\n\r\n### 🚀 Performance \u0026 Flexibility\r\n- **Fast Setup** - Databases ready in seconds\r\n- **Resource Efficient** - Optimized Docker configurations\r\n- **Multi-Database** - Run multiple instances simultaneously\r\n- **Environment Isolation** - Clean separation between projects\r\n\r\n### 📊 Comprehensive Database Support\r\n- **SQL Databases** - PostgreSQL, MariaDB, SQLite, DuckDB\r\n- **Time Series** - InfluxDB 2.x, InfluxDB 3 Core, TimescaleDB, QuestDB, VictoriaMetrics, HoraeDB\r\n- **Vector Search** - Qdrant, Weaviate, Milvus\r\n- **Search Engines** - Meilisearch, Typesense\r\n- **Specialized** - Redis, Cassandra, ArangoDB, LevelDB\r\n\r\n## 🔄 Dependency Management\r\n\r\n### Core Dependencies\r\n- **chalk** ^5.4.1 - Terminal colors and styling\r\n- **commander** ^12.1.0 - Command-line interface framework\r\n- **dockerode** ^4.0.7 - Docker Engine API client\r\n- **inquirer** ^9.2.12 - Interactive command-line prompts\r\n- **ora** ^8.2.0 - Loading spinners and progress indicators\r\n- **yaml** ^2.8.0 - YAML parser and stringifier\r\n\r\n### Development Dependencies\r\n- **typescript** ^5.8.3 - TypeScript compiler\r\n- **@types/node** ^22.10.6 - Node.js type definitions\r\n- **eslint** ^8.57.1 - Code linting\r\n- **jest** ^29.7.0 - Testing framework\r\n\r\nAll dependencies are regularly updated and security-audited.\r\n\r\n## 🎨 Project Branding\r\n\r\n### Logo Usage\r\nThe Hayai logo is located in the `assets/` directory:\r\n\r\n- **Main Logo**: `assets/logo_hayai.png` - Primary logo for README and documentation\r\n- **Complete Logo**: `assets/complete_logo_hayai.png` - Full logo with text\r\n- **Format**: PNG with transparent background\r\n- **Usage**: Free for open-source projects, attribution appreciated\r\n\r\n### GitHub Repository Settings\r\nTo use the logo in different GitHub contexts:\r\n\r\n1. **Social Preview**: Repository Settings → General → Social Preview (1280x640px)\r\n2. **README Header**: Already configured using `logo_hayai.png`\r\n3. **Issues/PRs**: Reference using `![Hayai Logo](assets/logo_hayai.png)`\r\n\r\n## 🤝 Contributing\r\n\r\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\r\n\r\n### Development Setup\r\n```bash\r\n# Clone the repository\r\ngit clone https://github.com/hitoshyamamoto/hayai.git\r\n\r\n# Install dependencies\r\nnpm install\r\n\r\n# Run in development mode\r\nnpm run dev\r\n\r\n# Run tests\r\nnpm test\r\n\r\n# Run linting\r\nnpm run lint\r\n```\r\n\r\n### 📖 Documentation\r\n- [Contributing Guide](CONTRIBUTING.md) - How to contribute to the project\r\n- [Development Guide](DEVELOPMENT.md) - Development setup and workflow\r\n- [.hayaidb Configuration](HAYAIDB.md) - Declarative database configuration guide\r\n- [Backup \u0026 Snapshots](ABOUT_BACKUP.md) - Complete backup and restoration guide\r\n\r\n## 📄 License\r\n\r\nMIT License - see [LICENSE](LICENSE) for details.\r\n\r\n## 🙏 Acknowledgments\r\n\r\n- **Docker** - Container platform that makes everything possible\r\n- **Open-source database communities** - For creating amazing databases\r\n- **Node.js ecosystem** - For excellent tooling and libraries\r\n- **Professional experience** - Real-world development needs and pain points that inspired this solution\r\n- **Personal curiosity** - The desire to create my first own project and learn through building\r\n\r\n---\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n  \u003cp\u003eBuilt to simplify and accelerate your development by \u003ca href=\"https://github.com/hitoshyamamoto\"\u003ehitoshyamamoto\u003c/a\u003e\u003c/p\u003e\r\n  \u003cp\u003e\u003cem\u003eMaking database management 速い (hayai) since 2025\u003c/em\u003e\u003c/p\u003e\r\n\u003c/div\u003e\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhitoshyamamoto%2Fhayai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhitoshyamamoto%2Fhayai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhitoshyamamoto%2Fhayai/lists"}