diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..8266b5b
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,6 @@
+MODEL_NAME=gpt-4-turbo-preview
+
+OPENAI_API_KEY=sk-xxxx..
+LANGFUSE_PUBLIC_KEY=pk-lf-...
+LANGFUSE_SECRET_KEY=sk-lf-...
+LANGFUSE_HOST=http://brunix-observability:3000
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6107db0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,148 @@
+# Brunix Assistance Engine
+
+The **Brunix Assistance Engine** is a high-performance, gRPC-powered AI orchestration service. It serves as the core intelligence layer for the Brunix ecosystem, integrating advanced RAG (Retrieval-Augmented Generation) capabilities with real-time observability.
+
+This project is a strategic joint development:
+* **[101OBEX Corp](https://101obex.com):** Infrastructure, System Architecture, and the proprietary **AVAP Technology** stack.
+* **[MrHouston](https://mrhouston.net):** Advanced LLM Fine-tuning, Model Training, and Prompt Engineering.
+
+---
+
+## System Architecture
+
+The following diagram illustrates the interaction between the AVAP technology, the trained intelligence, and the infrastructure components:
+
+```mermaid
+graph TD
+    subgraph Client_Layer [External Interface]
+        Client[External Services / UI]
+    end
+    
+    subgraph Engine_Layer
+        BE[Brunix Assistance Engine]
+        LG[LangGraph Logic]
+        LC[LangChain Framework]
+    end
+
+    subgraph Intelligence_Layer 
+        LLM[Fine-tuned Model / OpenAI or other]
+        Prompt[Prompt Engineering]
+    end
+
+    subgraph Data_Observability_Layer [System Support]
+        EDB[(Elasticsearch Vector DB)]
+        LF[Langfuse Observability]
+        PG[(Postgres - System Data)]
+    end
+
+    Client -- gRPC:50052 --> BE
+    BE --> LG
+    LG --> LC
+    LC --> LLM
+    LLM --> Prompt
+    LC -- Semantic Search --> EDB
+    LC -- Tracing/Metrics --> LF
+    LF -- Persistence --> PG
+```
+
+---
+
+## Technology Stack
+
+* **Logic Layer:** [LangChain](https://www.langchain.com/) & [LangGraph](https://langchain-ai.github.io/langgraph/) (Python 3.11).
+* **Communication:** [gRPC](https://grpc.io/) (High-performance, low-latency RPC framework).
+* **Vector Database:** [Elasticsearch 8.12](https://www.elastic.co/) (For semantic search and AVAP data retrieval).
+* **Observability:** [Langfuse](https://langfuse.com/) (End-to-end tracing, latency monitoring, and cost management).
+* **Infrastructure:** Dockerized environment with PostgreSQL 15 persistence.
+
+---
+
+## Getting Started
+
+### Prerequisites
+* Docker & Docker Compose
+* OpenAI API Key (or configured local provider)
+
+### Installation & Deployment
+
+1.  **Clone the repository:**
+    ```bash
+    git clone git@github.com:BRUNIX-AI/assistance-engine.git
+    cd assistance-engine
+    ```
+
+2.  **Configure Environment Variables:**
+    Create a `.env` file in the root directory:
+    ```env
+    OPENAI_API_KEY=your_key_here
+    LANGFUSE_PUBLIC_KEY=pk-lf-...
+    LANGFUSE_SECRET_KEY=sk-lf-...
+    LANGFUSE_HOST=http://langfuse:3000
+    ```
+
+3.  **Launch the Stack:**
+    ```bash
+    docker-compose up -d --build
+    ```
+
+The engine will be listening for gRPC requests on port `50052`.
+
+---
+
+## Component Overview
+
+| Service | Container Name | Description | Role |
+| :--- | :--- | :--- | :--- |
+| **Engine** | `brunix-assistance-engine` | The AVAP-powered brain. | 101OBEX Corp |
+| **Vector DB** | `brunix-vector-db` | Elasticsearch instance (Knowledge Base). | Training Support |
+| **Observability** | `brunix-observability` | Langfuse UI (Tracing & Costs). | System Quality |
+| **System DB** | `brunix-postgres` | Internal storage for Langfuse. | Infrastructure |
+
+---
+
+## Partnership & Contributions
+
+This repository is private and represents the intellectual property of **101OBEX Corp** and **MrHouston**. 
+
+* **Architecture & AVAP:** Managed by 101OBEX Engineering.
+* **Model Training & Intelligence:** Managed by MrHouston Data Science Team.
+
+---
+
+## Open Source & Intellectual Property
+
+The Brunix Assistance Engine is built on a hybrid architecture that balances the flexibility of open-source tools with the security of proprietary intelligence:
+
+* **Open Source Frameworks:** Utilizes **LangChain** and **LangGraph** (MIT License) for orchestration, and **gRPC** for high-performance communication.
+* **Infrastructure:** Deploys via **Docker** using **PostgreSQL** and **Elasticsearch** (Elastic License 2.0).
+* **Proprietary Logic:** The **AVAP Technology** (101OBEX Corp) and the specific **Model Training/Prompts** (MrHouston) are protected intellectual property.
+* **LLM Provider:** Currently configured for **OpenAI** (Proprietary SaaS). The modular design allows for future integration with locally-hosted Open Source models (e.g., Llama 3, Mistral) to ensure 100% data sovereignty if required.
+
+## Security & Privacy
+
+The system is designed with a "Security-First" approach to protect corporate intelligence:
+
+1. **Data in Transit:** Communication between the Engine and external clients is handled via **gRPC**, supporting **TLS/SSL encryption** to ensure that data remains private and tamper-proof.
+2. **Internal Networking:** All database interactions (Elasticsearch, PostgreSQL) occur within a **private Docker bridge network** (`avap-network`), isolated from the public internet.
+3. **Observability Governance:** **Langfuse** provides a full audit trail of every LLM interaction, allowing for real-time monitoring of data leakage or unexpected model behavior.
+4. **Enterprise Secret Management:** While local development uses `.env` files, the architecture is **Production-Ready for Kubernetes**. In production environments, sensitive credentials (API Keys, Database passwords) are managed via **Kubernetes Secrets** or **HashiCorp Vault**, ensuring that no sensitive data is stored within the container images or source control.
+
+```mermaid
+graph LR
+    subgraph Public_Internet
+        Client[External Client]
+    end
+    subgraph Encrypted_Tunnel [TLS/SSL]
+        gRPC[gRPC Protocol]
+    end
+    subgraph K8s_Cluster [Production Environment]
+        Engine[Brunix Engine]
+        Sec{{"Kubernetes Secrets"}} 
+        DB[(Databases)]
+    end
+
+    Client --> gRPC
+    gRPC --> Engine
+    Sec -.->|Injected as Env| Engine
+    Engine <--> DB
+```
\ No newline at end of file
diff --git a/changelog b/changelog
new file mode 100644
index 0000000..8b798ff
--- /dev/null
+++ b/changelog
@@ -0,0 +1,17 @@
+# Changelog
+
+All notable changes to the **Brunix Assistance Engine** will be documented in this file. This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [1.0.0] - 2026-02-09
+
+### Added
+
+- **System Architecture:** Implementation of the triple-layer stack (Engine, Vector DB, Observability).
+- **Core Engine:** Deployment of the `brunix-assistance-engine` using **Python 3.11**, **LangChain**, and **LangGraph** for agentic workflows.
+- **Communication Layer:** Established **gRPC** as the primary high-performance interface (Port 50051/50052).
+- **Knowledge Base:** Integration of **Elasticsearch 8.12** (`brunix-vector-db`) for AVAP technology RAG support.
+- **Observability Framework:** Deployment of **Langfuse** and **PostgreSQL** for full trace audit and cost management.
+- **Security:** Initial network isolation within Docker (`avap-network`) and production-ready secret management design.
+