https://github.com/ekodb/ekodb-client
Official ekoDB Client Package Repository
https://github.com/ekodb/ekodb-client
ai ai-agents client database eko ekodb
Last synced: 3 months ago
JSON representation
Official ekoDB Client Package Repository
- Host: GitHub
- URL: https://github.com/ekodb/ekodb-client
- Owner: ekoDB
- License: mit
- Created: 2024-10-26T16:58:50.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-04-06T14:53:47.000Z (3 months ago)
- Last Synced: 2026-04-06T15:30:57.779Z (3 months ago)
- Topics: ai, ai-agents, client, database, eko, ekodb
- Language: Rust
- Homepage: https://docs.ekodb.io
- Size: 22.4 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ekoDB Client Libraries
Official client libraries for ekoDB - a high-performance document database.
[](examples/)
[](examples/)
[](examples/)
**🚀 Quick Stats:**
- **288 working examples** - 237 client library + 51 direct API examples
- **6 programming languages** - Rust, Python, Go, TypeScript, JavaScript, Kotlin
- **5 full-featured clients** - Complete feature parity across Rust, Python, Go,
TypeScript, Kotlin
- **14 examples per client** - CRUD, batch ops, queries, joins, search,
WebSocket, AI/chat, and more
- **100% tested** - All examples run in CI/CD
## 📦 Available Clients
### 🦀 Rust Client (`ekodb_client`)
[](https://crates.io/crates/ekodb_client)
[](https://docs.rs/ekodb_client)
```bash
cargo add ekodb_client
```
### 🐍 Python Client (`ekodb-client`)
[](https://pypi.org/project/ekodb-client/)
[](https://pypi.org/project/ekodb-client/)
```bash
pip install ekodb-client
```
### 🔷 Go Client
[](https://pkg.go.dev/github.com/ekoDB/ekodb-client-go)
[](https://goreportcard.com/report/github.com/ekoDB/ekodb-client-go)
```bash
go get github.com/ekoDB/ekodb-client-go
```
**Note:** Go client is maintained in a separate repository:
[github.com/ekoDB/ekodb-client-go](https://github.com/ekoDB/ekodb-client-go)
### 📘 TypeScript/JavaScript Client
[](https://www.npmjs.com/package/@ekodb/ekodb-client)
[](https://www.npmjs.com/package/@ekodb/ekodb-client)
```bash
npm install @ekodb/ekodb-client
```
### 🟣 Kotlin Client (`ekodb-client-kt`)
[](https://central.sonatype.com/artifact/io.ekodb/ekodb-client-kt)
```kotlin
// Gradle (Kotlin DSL)
implementation("io.ekodb:ekodb-client-kt:0.1.0")
```
**Features:**
- ✅ Full coroutines support
- ✅ Type-safe operations
- ✅ Fluent query builder with joins
- ✅ WebSocket real-time queries
- ✅ AI/Chat integration
- ✅ Schema management
- ✅ Full-text search
- ✅ 14 comprehensive examples
## Features
All clients provide:
- ✅ Type-safe database operations
- ✅ Comprehensive CRUD operations
- ✅ Batch operations (insert, update, delete)
- ✅ Authentication handling
- ✅ Query filtering and sorting with joins
- ✅ Schema management and validation
- ✅ Full-text search capabilities
- ✅ WebSocket real-time queries
- ✅ AI/Chat integration with context retrieval
- ✅ TTL (time-to-live) support
- ✅ Key-value operations
- ✅ Error handling and retries
Each client also includes language-specific features:
- **Rust**: Tokio async runtime, strong type safety, zero-cost abstractions
- **Python**: Async/await support, type hints, modern Python 3.8+
- **Go**: Context support, idiomatic error handling, goroutines
- **TypeScript/JavaScript**: TypeScript support, Promises, Node.js compatibility
- **Kotlin**: Coroutines, null safety, extension functions, fluent APIs
## 📚 Documentation
- [Rust Client Documentation](https://docs.rs/ekodb_client)
- [Python Client Documentation](./ekodb-client-py/README.md)
- [Go Client Documentation](https://github.com/ekoDB/ekodb-client-go) - Separate
repository
- [TypeScript Client Documentation](./ekodb-client-ts/README.md)
- [Kotlin Client Documentation](./ekodb-client-kt/README.md)
- [Examples](./examples/) - Code examples across all available languages (14
examples per client)
## 🛠️ Development
See [COMMANDS.md](./COMMANDS.md) for detailed command reference.
### Quick Start
```bash
# Build Rust client
make build
# Build Python client
make build-python-client
# Build TypeScript client
make build-typescript-client
# Build Kotlin client
make build-kotlin-client
# Run all tests
make test
# Run examples for all languages
make test-examples
# Run Kotlin examples specifically
make test-examples-kt
```
### Deployment
```bash
# Deploy Rust client to crates.io
make deploy-client-rust
# Deploy Python client to PyPI
make bump-client-py # Bump version
make deploy-client-py # Build & publish (Linux + macOS + source)
# Deploy TypeScript client to npm
make deploy-client-ts
# Deploy Go client (via git tags)
make deploy-client-go
# Deploy Kotlin client to Maven Central
cd ekodb-client-kt && ./gradlew publish
```
## License
MIT