athar 0.1.0__tar.gz

athar-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Abdur Rafay
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

athar-0.1.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include LICENSE
+include README.md
+include pyproject.toml
+recursive-include src/athar/ui/static *
+recursive-include assets *.svg

athar-0.1.0/PKG-INFO

@@ -0,0 +1,236 @@
+Metadata-Version: 2.4
+Name: athar
+Version: 0.1.0
+Summary: A local-first, time-travel debugger for multi-agent LLM systems.
+Author: Abdur-Rafay-AR
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Abdur-Rafay-AR/athar
+Project-URL: Repository, https://github.com/Abdur-Rafay-AR/athar
+Project-URL: Issues, https://github.com/Abdur-Rafay-AR/athar/issues
+Keywords: llm,agents,observability,debugger,time-travel,multi-agent,tracing,local-first
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Debuggers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi>=0.100.0
+Requires-Dist: uvicorn>=0.23.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: httpx>=0.24.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=5.0.0; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+
+  <img src="assets/logo.svg" alt="Athar Logo" width="130" />
+
+  # athar (أثر)
+  
+  **A local-first, time-travel debugger and observability engine for multi-agent LLM systems.**
+
+  [![Tests](https://img.shields.io/badge/tests-13%20passed-00D6A3.svg)](tests/)
+  [![Python](https://img.shields.io/badge/python-3.9%20%7C%203.10%20%7C%203.11%20%7C%203.12-blue.svg)](https://www.python.org/)
+  [![License: MIT](https://img.shields.io/badge/License-MIT-00D6A3.svg)](LICENSE)
+  [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
+  [![Local First](https://img.shields.io/badge/storage-SQLite%20WAL-101820.svg)](#architecture)
+
+  <br />
+
+  <p align="center">
+    <code>fork</code> &nbsp;&bull;&nbsp; <code>edit</code> &nbsp;&bull;&nbsp; <code>replay</code>
+  </p>
+
+  <p align="center">
+    <i>No account. No cloud fees. No vendor lock-in. Just SQLite on disk, a sleek local web UI, and instantaneous time-travel replays.</i>
+  </p>
+
+</div>
+
+---
+
+## 💡 Why Athar?
+
+If you have built anything beyond a single-prompt toy, you've encountered this nightmare:
+
+> *Your multi-agent loop fails on step 6 of 10. You add a `print()` statement, re-run the entire pipeline, burn hundreds of thousands of tokens, wait 45 seconds, and... it succeeds this time because LLMs are stochastic.*
+
+Existing observability platforms (LangSmith, Phoenix, Langfuse) solve **logging**—you can see what went wrong after the fact. **None of them solve interactive debugging**:
+
+- ❌ Re-running from scratch burns money and wastes time.
+- ❌ SaaS observability platforms require sending private prompts, embeddings, and customer data to external cloud vendors.
+- ❌ You cannot easily mutate the state at step 4 and test *“what if the tool returned X instead?”*.
+
+### The Athar Solution: **Fork & Replay**
+
+Athar records every execution step (prompts, tool calls, tool results, state snapshots) into a local SQLite database using Write-Ahead Logging (WAL). 
+
+When an agent goes off track:
+1. **Scrub** through the execution timeline in the local web UI.
+2. **Select** the exact step where things went wrong.
+3. **Mutate** the prompt, tool output, or agent state in the inspector.
+4. **Hit Replay**: Athar resumes execution from that step forward. **Prior steps are never re-executed**, saving your API credits and minutes of wait time.
+5. Athar creates a new branch in the trace graph, letting you compare the original vs. mutated paths side-by-side.
+
+---
+
+## ⚡ 10-Second Quickstart
+
+### 1. Installation
+
+```bash
+git clone https://github.com/Abdur-Rafay-AR/athar.git
+cd athar
+pip install -e .
+```
+
+### 2. Instrument Your Code
+
+Wrap any agent or tool function with `@traced`:
+
+```python
+import asyncio
+from athar import traced, TracerContext
+
+@traced
+async def search_tool(query: str):
+    # Simulating a search tool or API lookup
+    await asyncio.sleep(0.2)
+    return {"results": f"Found latest data for: {query}"}
+
+@traced
+async def research_agent(topic: str):
+    print(f"Researching: {topic}")
+    data = await search_tool(topic)
+    return f"Synthesized report based on {data['results']}"
+
+async def main():
+    # Bundle execution inside a named trace session
+    async with TracerContext(name="Market Intelligence Run"):
+        report = await research_agent("Autonomous Coding Agents")
+        print("Done:", report)
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+### 3. Open the Athar Debugger UI
+
+Start the local server:
+
+```bash
+athar
+```
+*(Or run `run-local.cmd` on Windows).*
+
+Open **[http://localhost:4173](http://localhost:4173)** to scrub through steps, inspect inputs/outputs, and initiate time-travel replays!
+
+---
+
+## 🏛️ Architecture
+
+```mermaid
+flowchart TD
+    subgraph AgentApp["Your Agent Application"]
+        A["Agent Orchestrator"] --> B["Tool Calls & LLM Queries"]
+    end
+
+    subgraph AtharSDK["Athar SDK (Instrumentation)"]
+        T["@traced / TracerContext"]
+        H["SHA-256 Content Hasher"]
+        C["ContextVar Call Tree Tracker"]
+    end
+
+    subgraph Storage["Local Storage Layer"]
+        DB[("SQLite WAL Store\nagent_traces.db")]
+    end
+
+    subgraph WebUI["Athar Web UI (FastAPI)"]
+        UI["Interactive Timeline & DAG Inspector"]
+        FR["Fork & Replay State Mutator"]
+    end
+
+    AgentApp -->|wraps execution| AtharSDK
+    AtharSDK -->|async WAL writes| Storage
+    Storage <-->|reads & branches| WebUI
+    FR -.->|re-executes branch| AgentApp
+```
+
+### System Architecture Highlights
+
+- **SQLite WAL Mode**: Thread-safe, non-blocking concurrent writes from high-throughput agent loops while the Web UI live-polls data.
+- **Deterministic Content Hashing**: Every step generates a SHA-256 fingerprint based on inputs, state, and function signatures.
+- **ContextVar Hierarchy Chaining**: Automatically preserves parent-child relationships across nested agent calls and async tasks without messy manual span propagation.
+
+---
+
+## ✨ Features
+
+- 🌿 **Time-Travel Fork & Replay**: Edit inputs or state snapshots at any node and re-execute downstream steps without re-running earlier nodes.
+- 🔒 **100% Local & Private**: No cloud credentials, zero telemetry, no external database dependencies. Your sensitive prompts and proprietary agent code never leave your machine.
+- ⚡ **Zero-Overhead Instrumentation**: Drop-in `@traced` decorator and `TracerContext` context manager with negligible runtime impact.
+- 📊 **Step Inspector**: Real-time view of inputs, arguments, outputs, errors, latency, and cost per step.
+- 🔌 **Framework Agnostic**: Works out of the box with raw Python loops, LangChain, AutoGen, CrewAI, and Crucible.
+- 🎨 **Modern Dark-Mode UI**: Built with a clean aesthetic, interactive timeline cards, and in-browser state mutation editor.
+
+---
+
+## 🖥️ CLI Commands
+
+```bash
+# Launch Athar UI on default port 4173
+athar
+
+# Launch on custom port and host
+athar --port 8080 --host 0.0.0.0
+
+# Point to a custom SQLite database file
+athar --db ./path/to/my_traces.db
+```
+
+---
+
+## 🛠️ Development & Testing
+
+We welcome contributions! Run the automated test suite with Python's built-in `unittest` or `pytest`:
+
+```bash
+# Install with dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+python -m unittest discover -s tests
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for details on development workflows, adapters, and style guidelines.
+
+---
+
+## 🗺️ Roadmap
+
+- [x] **v0.1**: Local-first tracer SDK, SQLite WAL store, FastAPI server, interactive timeline UI, fork & replay mechanics.
+- [ ] **v0.2**: Side-by-side branch diff visualizer (compare outputs, cost differences, and token latency between two forks).
+- [ ] **v0.3**: Native adapters for LangChain callback handlers and AutoGen conversation listeners.
+- [ ] **v0.4**: Live trace streaming via WebSockets / Server-Sent Events (SSE).
+- [ ] **v1.0**: Stable SDK API, export traces to OpenTelemetry, and team sharing utilities.
+
+---
+
+## 📜 Meaning of "Athar"
+
+**Athar** (أثر) is an Arabic word meaning **trace**, **imprint**, or **footprint**. In agentic AI systems, understanding the exact trace left behind by an agent's reasoning process is the key to mastering reliability, interpretability, and deterministic debugging.
+
+---
+
+## 📄 License
+
+Distributed under the [MIT License](LICENSE). Copyright © 2026 Abdur Rafay.

athar-0.1.0/README.md

@@ -0,0 +1,204 @@
+<div align="center">
+
+  <img src="assets/logo.svg" alt="Athar Logo" width="130" />
+
+  # athar (أثر)
+  
+  **A local-first, time-travel debugger and observability engine for multi-agent LLM systems.**
+
+  [![Tests](https://img.shields.io/badge/tests-13%20passed-00D6A3.svg)](tests/)
+  [![Python](https://img.shields.io/badge/python-3.9%20%7C%203.10%20%7C%203.11%20%7C%203.12-blue.svg)](https://www.python.org/)
+  [![License: MIT](https://img.shields.io/badge/License-MIT-00D6A3.svg)](LICENSE)
+  [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
+  [![Local First](https://img.shields.io/badge/storage-SQLite%20WAL-101820.svg)](#architecture)
+
+  <br />
+
+  <p align="center">
+    <code>fork</code> &nbsp;&bull;&nbsp; <code>edit</code> &nbsp;&bull;&nbsp; <code>replay</code>
+  </p>
+
+  <p align="center">
+    <i>No account. No cloud fees. No vendor lock-in. Just SQLite on disk, a sleek local web UI, and instantaneous time-travel replays.</i>
+  </p>
+
+</div>
+
+---
+
+## 💡 Why Athar?
+
+If you have built anything beyond a single-prompt toy, you've encountered this nightmare:
+
+> *Your multi-agent loop fails on step 6 of 10. You add a `print()` statement, re-run the entire pipeline, burn hundreds of thousands of tokens, wait 45 seconds, and... it succeeds this time because LLMs are stochastic.*
+
+Existing observability platforms (LangSmith, Phoenix, Langfuse) solve **logging**—you can see what went wrong after the fact. **None of them solve interactive debugging**:
+
+- ❌ Re-running from scratch burns money and wastes time.
+- ❌ SaaS observability platforms require sending private prompts, embeddings, and customer data to external cloud vendors.
+- ❌ You cannot easily mutate the state at step 4 and test *“what if the tool returned X instead?”*.
+
+### The Athar Solution: **Fork & Replay**
+
+Athar records every execution step (prompts, tool calls, tool results, state snapshots) into a local SQLite database using Write-Ahead Logging (WAL). 
+
+When an agent goes off track:
+1. **Scrub** through the execution timeline in the local web UI.
+2. **Select** the exact step where things went wrong.
+3. **Mutate** the prompt, tool output, or agent state in the inspector.
+4. **Hit Replay**: Athar resumes execution from that step forward. **Prior steps are never re-executed**, saving your API credits and minutes of wait time.
+5. Athar creates a new branch in the trace graph, letting you compare the original vs. mutated paths side-by-side.
+
+---
+
+## ⚡ 10-Second Quickstart
+
+### 1. Installation
+
+```bash
+git clone https://github.com/Abdur-Rafay-AR/athar.git
+cd athar
+pip install -e .
+```
+
+### 2. Instrument Your Code
+
+Wrap any agent or tool function with `@traced`:
+
+```python
+import asyncio
+from athar import traced, TracerContext
+
+@traced
+async def search_tool(query: str):
+    # Simulating a search tool or API lookup
+    await asyncio.sleep(0.2)
+    return {"results": f"Found latest data for: {query}"}
+
+@traced
+async def research_agent(topic: str):
+    print(f"Researching: {topic}")
+    data = await search_tool(topic)
+    return f"Synthesized report based on {data['results']}"
+
+async def main():
+    # Bundle execution inside a named trace session
+    async with TracerContext(name="Market Intelligence Run"):
+        report = await research_agent("Autonomous Coding Agents")
+        print("Done:", report)
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+### 3. Open the Athar Debugger UI
+
+Start the local server:
+
+```bash
+athar
+```
+*(Or run `run-local.cmd` on Windows).*
+
+Open **[http://localhost:4173](http://localhost:4173)** to scrub through steps, inspect inputs/outputs, and initiate time-travel replays!
+
+---
+
+## 🏛️ Architecture
+
+```mermaid
+flowchart TD
+    subgraph AgentApp["Your Agent Application"]
+        A["Agent Orchestrator"] --> B["Tool Calls & LLM Queries"]
+    end
+
+    subgraph AtharSDK["Athar SDK (Instrumentation)"]
+        T["@traced / TracerContext"]
+        H["SHA-256 Content Hasher"]
+        C["ContextVar Call Tree Tracker"]
+    end
+
+    subgraph Storage["Local Storage Layer"]
+        DB[("SQLite WAL Store\nagent_traces.db")]
+    end
+
+    subgraph WebUI["Athar Web UI (FastAPI)"]
+        UI["Interactive Timeline & DAG Inspector"]
+        FR["Fork & Replay State Mutator"]
+    end
+
+    AgentApp -->|wraps execution| AtharSDK
+    AtharSDK -->|async WAL writes| Storage
+    Storage <-->|reads & branches| WebUI
+    FR -.->|re-executes branch| AgentApp
+```
+
+### System Architecture Highlights
+
+- **SQLite WAL Mode**: Thread-safe, non-blocking concurrent writes from high-throughput agent loops while the Web UI live-polls data.
+- **Deterministic Content Hashing**: Every step generates a SHA-256 fingerprint based on inputs, state, and function signatures.
+- **ContextVar Hierarchy Chaining**: Automatically preserves parent-child relationships across nested agent calls and async tasks without messy manual span propagation.
+
+---
+
+## ✨ Features
+
+- 🌿 **Time-Travel Fork & Replay**: Edit inputs or state snapshots at any node and re-execute downstream steps without re-running earlier nodes.
+- 🔒 **100% Local & Private**: No cloud credentials, zero telemetry, no external database dependencies. Your sensitive prompts and proprietary agent code never leave your machine.
+- ⚡ **Zero-Overhead Instrumentation**: Drop-in `@traced` decorator and `TracerContext` context manager with negligible runtime impact.
+- 📊 **Step Inspector**: Real-time view of inputs, arguments, outputs, errors, latency, and cost per step.
+- 🔌 **Framework Agnostic**: Works out of the box with raw Python loops, LangChain, AutoGen, CrewAI, and Crucible.
+- 🎨 **Modern Dark-Mode UI**: Built with a clean aesthetic, interactive timeline cards, and in-browser state mutation editor.
+
+---
+
+## 🖥️ CLI Commands
+
+```bash
+# Launch Athar UI on default port 4173
+athar
+
+# Launch on custom port and host
+athar --port 8080 --host 0.0.0.0
+
+# Point to a custom SQLite database file
+athar --db ./path/to/my_traces.db
+```
+
+---
+
+## 🛠️ Development & Testing
+
+We welcome contributions! Run the automated test suite with Python's built-in `unittest` or `pytest`:
+
+```bash
+# Install with dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+python -m unittest discover -s tests
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for details on development workflows, adapters, and style guidelines.
+
+---
+
+## 🗺️ Roadmap
+
+- [x] **v0.1**: Local-first tracer SDK, SQLite WAL store, FastAPI server, interactive timeline UI, fork & replay mechanics.
+- [ ] **v0.2**: Side-by-side branch diff visualizer (compare outputs, cost differences, and token latency between two forks).
+- [ ] **v0.3**: Native adapters for LangChain callback handlers and AutoGen conversation listeners.
+- [ ] **v0.4**: Live trace streaming via WebSockets / Server-Sent Events (SSE).
+- [ ] **v1.0**: Stable SDK API, export traces to OpenTelemetry, and team sharing utilities.
+
+---
+
+## 📜 Meaning of "Athar"
+
+**Athar** (أثر) is an Arabic word meaning **trace**, **imprint**, or **footprint**. In agentic AI systems, understanding the exact trace left behind by an agent's reasoning process is the key to mastering reliability, interpretability, and deterministic debugging.
+
+---
+
+## 📄 License
+
+Distributed under the [MIT License](LICENSE). Copyright © 2026 Abdur Rafay.

athar-0.1.0/assets/logo-banner.svg

@@ -0,0 +1,65 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="880" height="220" viewBox="0 0 880 220" fill="none" role="img" aria-label="Athar Banner">
+  <defs>
+    <radialGradient id="banner-glow" cx="18%" cy="50%" r="55%">
+      <stop offset="0%" stop-color="#163140" stop-opacity="0.9"/>
+      <stop offset="60%" stop-color="#101820" stop-opacity="1"/>
+      <stop offset="100%" stop-color="#090e13" stop-opacity="1"/>
+    </radialGradient>
+    <filter id="banner-teal-glow" x="-50%" y="-50%" width="200%" height="200%">
+      <feGaussianBlur in="SourceGraphic" stdDeviation="4" result="blur"/>
+      <feMerge>
+        <feMergeNode in="blur"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+    <linearGradient id="banner-line-grad" x1="0%" y1="0%" x2="0%" y2="100%">
+      <stop offset="0%" stop-color="#FFFFFF"/>
+      <stop offset="100%" stop-color="#C2D3DE"/>
+    </linearGradient>
+  </defs>
+
+  <!-- Background container -->
+  <rect width="880" height="220" rx="20" fill="url(#banner-glow)"/>
+  <rect width="878" height="218" x="1" y="1" rx="19" stroke="#1d3442" stroke-width="1.2" fill="none"/>
+
+  <!-- Left: Emblem / Trace Mark -->
+  <g transform="translate(60, 42)">
+    <path d="M68 16 V55 M68 55 L32 96 M68 55 V104 M68 55 L104 96"
+          stroke="url(#banner-line-grad)" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round" fill="none"/>
+    <circle cx="68" cy="14" r="6.5" fill="#00D6A3" filter="url(#banner-teal-glow)"/>
+    <circle cx="68" cy="55" r="5.5" fill="#00D6A3" stroke="#101820" stroke-width="2.5" filter="url(#banner-teal-glow)"/>
+    <circle cx="32" cy="98" r="6.5" fill="#00D6A3" filter="url(#banner-teal-glow)"/>
+    <circle cx="68" cy="106" r="6.5" fill="#00D6A3" filter="url(#banner-teal-glow)"/>
+    <circle cx="104" cy="98" r="6.5" fill="#00D6A3" filter="url(#banner-teal-glow)"/>
+  </g>
+
+  <!-- Right: Title, Slogan, and Details -->
+  <g transform="translate(230, 48)">
+    <!-- Brand Title -->
+    <text x="0" y="44"
+          font-family="'Space Grotesk', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif"
+          font-size="48" font-weight="700" letter-spacing="0.02em" fill="#F4F7FA">athar</text>
+
+    <!-- Tagline pill -->
+    <rect x="140" y="16" width="168" height="26" rx="13" fill="#172b38" stroke="#00D6A3" stroke-opacity="0.35" stroke-width="1"/>
+    <text x="224" y="33" text-anchor="middle"
+          font-family="'Space Grotesk', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif"
+          font-size="11" font-weight="600" letter-spacing="0.1em" fill="#00D6A3">FORK &#183; EDIT &#183; REPLAY</text>
+
+    <!-- Subtitle -->
+    <text x="0" y="80"
+          font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif"
+          font-size="16" font-weight="400" fill="#B3C4D0">
+      Local-first, time-travel debugger &amp; observability for multi-agent LLM systems.
+    </text>
+
+    <!-- Feature badges line -->
+    <g transform="translate(0, 102)">
+      <text x="0" y="14"
+            font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif"
+            font-size="12.5" font-weight="500" fill="#7E96A6">
+        &#x2714; Zero Cloud Lock-in &nbsp;&bull;&nbsp; &#x2714; SQLite Local Tracing &nbsp;&bull;&nbsp; &#x2714; Interactive Visual Timeline
+      </text>
+    </g>
+  </g>
+</svg>

athar-0.1.0/assets/logo-icon.svg

@@ -0,0 +1,18 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="136" height="136" viewBox="0 0 136 136" fill="none" role="img" aria-label="Athar Icon">
+  <defs>
+    <filter id="icon-glow" x="-50%" y="-50%" width="200%" height="200%">
+      <feGaussianBlur in="SourceGraphic" stdDeviation="3" result="blur"/>
+      <feMerge>
+        <feMergeNode in="blur"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+  </defs>
+  <path d="M68 16 V55 M68 55 L32 96 M68 55 V104 M68 55 L104 96"
+        stroke="#F4F7FA" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round" fill="none"/>
+  <circle cx="68" cy="14" r="6.5" fill="#00D6A3" filter="url(#icon-glow)"/>
+  <circle cx="68" cy="55" r="5.5" fill="#00D6A3" stroke="#101820" stroke-width="2.5" filter="url(#icon-glow)"/>
+  <circle cx="32" cy="98" r="6.5" fill="#00D6A3" filter="url(#icon-glow)"/>
+  <circle cx="68" cy="106" r="6.5" fill="#00D6A3" filter="url(#icon-glow)"/>
+  <circle cx="104" cy="98" r="6.5" fill="#00D6A3" filter="url(#icon-glow)"/>
+</svg>

athar-0.1.0/assets/logo.svg

@@ -0,0 +1,41 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="200" height="200" viewBox="0 0 200 200" fill="none" role="img" aria-label="Athar Logo">
+  <defs>
+    <radialGradient id="athar-bg" cx="50%" cy="40%" r="65%">
+      <stop offset="0%" stop-color="#162c38"/>
+      <stop offset="55%" stop-color="#101820"/>
+      <stop offset="100%" stop-color="#090e13"/>
+    </radialGradient>
+    <filter id="teal-glow" x="-50%" y="-50%" width="200%" height="200%">
+      <feGaussianBlur in="SourceGraphic" stdDeviation="3.5" result="blur"/>
+      <feMerge>
+        <feMergeNode in="blur"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+    <linearGradient id="trace-line-grad" x1="0%" y1="0%" x2="0%" y2="100%">
+      <stop offset="0%" stop-color="#FFFFFF"/>
+      <stop offset="100%" stop-color="#C2D3DE"/>
+    </linearGradient>
+  </defs>
+
+  <!-- Sleek rounded squircle container -->
+  <rect width="200" height="200" rx="44" fill="url(#athar-bg)"/>
+  <rect width="198" height="198" x="1" y="1" rx="43" stroke="#1d3442" stroke-width="1.5" fill="none"/>
+
+  <!-- Trace DAG Symbol (Centered, Pure Mark Only) -->
+  <g transform="translate(15, 25) scale(1.25)">
+    <!-- Branching paths -->
+    <path d="M68 16 V55 M68 55 L32 96 M68 55 V104 M68 55 L104 96"
+          stroke="url(#trace-line-grad)" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round" fill="none"/>
+
+    <!-- Glowing connection nodes -->
+    <!-- Root node -->
+    <circle cx="68" cy="14" r="6.5" fill="#00D6A3" filter="url(#teal-glow)"/>
+    <!-- Fork decision node -->
+    <circle cx="68" cy="55" r="5.5" fill="#00D6A3" stroke="#101820" stroke-width="2.5" filter="url(#teal-glow)"/>
+    <!-- Branch leaves -->
+    <circle cx="32" cy="98" r="6.5" fill="#00D6A3" filter="url(#teal-glow)"/>
+    <circle cx="68" cy="106" r="6.5" fill="#00D6A3" filter="url(#teal-glow)"/>
+    <circle cx="104" cy="98" r="6.5" fill="#00D6A3" filter="url(#teal-glow)"/>
+  </g>
+</svg>

athar-0.1.0/pyproject.toml

@@ -0,0 +1,63 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "athar"
+version = "0.1.0"
+description = "A local-first, time-travel debugger for multi-agent LLM systems."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [
+    { name = "Abdur-Rafay-AR" }
+]
+keywords = [
+    "llm",
+    "agents",
+    "observability",
+    "debugger",
+    "time-travel",
+    "multi-agent",
+    "tracing",
+    "local-first"
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Debuggers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "fastapi>=0.100.0",
+    "uvicorn>=0.23.0",
+    "pydantic>=2.0.0"
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "httpx>=0.24.0",
+    "build>=1.0.0",
+    "twine>=5.0.0"
+]
+
+[project.scripts]
+athar = "athar.ui.app:main"
+agent-tracer = "athar.ui.app:main"
+
+[project.urls]
+Homepage = "https://github.com/Abdur-Rafay-AR/athar"
+Repository = "https://github.com/Abdur-Rafay-AR/athar"
+Issues = "https://github.com/Abdur-Rafay-AR/athar/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"athar.ui" = ["static/*", "static/**/*"]

athar-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+