Latha DB - The Human-Scalable Database Platform

Latha DB is a next-generation programmable database engine. It merges the flexibility of Lisp-based querying with enterprise-grade features like Hybrid Storage, AI Vectors, and Clustering.

NOTICE

NOTICE

1. Key Features

🖥️ Advanced UI

• Modern Interface: Clean Swing-based GUI with Dark/Light modes.
• Hex Viewer: Inspect binary blobs and internal storage structures.
• Creator Studio: Visually design schemas and tables.

🌐 Connectivity

• Client-Server Architecture: Run headless and connect remotely.
• Load Balanced: Supports Master/Replica clustering for high availability.
• REST API: Integrated web server for HTTP-based queries.

⚙️ The Engine

• Vector Search (AI): Native support for Embeddings and Cosine Similarity (VECTOR type).
• Time-Travel: Immutable storage allowing (get-timeline) historical queries.
• Transactions: Full ACID support with WAL (Write-Ahead-Logging).
• Automation: Event-driven triggers (before-insert, after-update).

🧩 Extensibility

• Plugins: Load .jar extensions at runtime to add new Lisp commands.
• Scriptable: Full Turing-complete Lisp dialect for UDFs.

2. Quick Start

Prerequisites: Java 8+

Graphical Mode (Default)

Launch the full UI environment:

java -jar LathaDB.jar

Server Mode (Headless)

Start the Master server listening on port 8888:

java -jar LathaDB.jar --server

Command-Line Interface (CLI)

Start an interactive terminal session:

java -jar LathaDB.jar --cli

3. Building from Source

1. Compile:

   mkdir bin
   javac -d bin -sourcepath src/main/java src/main/java/com/lathadb/**/*.java

2. Package:

   jar cvfe LathaDB.jar com.lathadb.Main -C bin .

4. Documentation

See ARCHITECTURE.md for system design and CONTRIBUTING.md for contribution guidelines.