forked from Rockachopa/Timmy-time-dashboard
Merge pull request #9 from Alexspayne/claude/analyze-tool-contributions-J4nFy
This commit is contained in:
Alexander Whitestone
226
AGENTS.md
Normal file
226
AGENTS.md
Normal file
@@ -0,0 +1,226 @@
|
|||||||
|
# AGENTS.md — Timmy Time Development Standards for AI Agents
|
||||||
|
|
||||||
|
This file is the authoritative reference for any AI agent (Claude, Kimi, Manus,
|
||||||
|
or future tools) contributing to this repository. Read it first. Every time.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. Project at a Glance
|
||||||
|
|
||||||
|
**Timmy Time** is a local-first, sovereign AI agent system. No cloud. No telemetry.
|
||||||
|
Bitcoin Lightning economics baked in.
|
||||||
|
|
||||||
|
| Thing | Value |
|
||||||
|
|------------------|----------------------------------------|
|
||||||
|
| Language | Python 3.11+ |
|
||||||
|
| Web framework | FastAPI + Jinja2 + HTMX |
|
||||||
|
| Agent framework | Agno (wraps Ollama or AirLLM) |
|
||||||
|
| Persistence | SQLite (`timmy.db`, `data/swarm.db`) |
|
||||||
|
| Tests | pytest — 228 passing, **must stay green** |
|
||||||
|
| Entry points | `timmy`, `timmy-serve`, `self-tdd` |
|
||||||
|
| Config | pydantic-settings, reads `.env` |
|
||||||
|
|
||||||
|
```
|
||||||
|
src/
|
||||||
|
config.py # Central settings (OLLAMA_URL, DEBUG, etc.)
|
||||||
|
timmy/ # Core agent: agent.py, backends.py, cli.py, prompts.py
|
||||||
|
dashboard/ # FastAPI app + routes + Jinja2 templates
|
||||||
|
app.py
|
||||||
|
store.py # In-memory MessageLog singleton
|
||||||
|
routes/ # agents, health, swarm, swarm_ws, marketplace,
|
||||||
|
│ # mobile, mobile_test, voice, voice_enhanced
|
||||||
|
templates/ # base.html + page templates + partials/
|
||||||
|
swarm/ # Multi-agent coordinator, registry, bidder, tasks, comms
|
||||||
|
timmy_serve/ # L402 Lightning proxy, payment handler, TTS, CLI
|
||||||
|
voice/ # NLU intent detection (regex-based, no cloud)
|
||||||
|
websocket/ # WebSocket manager (ws_manager singleton)
|
||||||
|
notifications/ # Push notification store (notifier singleton)
|
||||||
|
shortcuts/ # Siri Shortcuts API endpoints
|
||||||
|
self_tdd/ # Continuous test watchdog
|
||||||
|
tests/ # One test_*.py per module, all mocked
|
||||||
|
static/style.css # Dark mission-control theme (JetBrains Mono)
|
||||||
|
docs/ # GitHub Pages site (docs/index.html)
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. Non-Negotiable Rules
|
||||||
|
|
||||||
|
1. **Tests must stay green.** Run `make test` before committing. If you break
|
||||||
|
tests, fix them before you do anything else.
|
||||||
|
2. **No cloud dependencies.** All computation must run on localhost.
|
||||||
|
3. **No new top-level files without purpose.** Don't litter the root directory.
|
||||||
|
4. **Follow existing patterns** — singletons (`message_log`, `notifier`,
|
||||||
|
`ws_manager`, `coordinator`), graceful degradation (try/except → fallback),
|
||||||
|
pydantic-settings config.
|
||||||
|
5. **Security defaults:** Never hard-code secrets. Warn at startup when defaults
|
||||||
|
are in use (see `l402_proxy.py` and `payment_handler.py` for the pattern).
|
||||||
|
6. **XSS prevention:** Never use `innerHTML` with untrusted content. Use
|
||||||
|
`textContent` or `innerText` for any user-controlled string in JS.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. Per-Agent Assignments
|
||||||
|
|
||||||
|
### Claude (Anthropic)
|
||||||
|
**Strengths:** Architecture, scaffolding, iterative refinement, testing, docs, breadth.
|
||||||
|
|
||||||
|
**Best for:**
|
||||||
|
- Adding new subsystems from scratch
|
||||||
|
- Refactoring / code-quality passes
|
||||||
|
- Writing or fixing tests
|
||||||
|
- Updating documentation (README, AGENTS.md, inline comments)
|
||||||
|
- CI/CD and tooling
|
||||||
|
- Debugging tricky async or import issues
|
||||||
|
|
||||||
|
**Conventions to follow:**
|
||||||
|
- Prefer editing existing files over creating new ones
|
||||||
|
- Keep route files thin — business logic lives in the module, not the route
|
||||||
|
- Use `from config import settings` for all env-var access
|
||||||
|
- New routes go in `src/dashboard/routes/`, registered in `app.py`
|
||||||
|
- New templates extend `base.html`
|
||||||
|
- Always add a corresponding `tests/test_<module>.py`
|
||||||
|
|
||||||
|
**Avoid:**
|
||||||
|
- Large one-shot feature dumps (that's Kimi's lane)
|
||||||
|
- Touching `src/swarm/coordinator.py` for security work (that's Manus's lane)
|
||||||
|
- Committing with `--no-verify`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Kimi (Moonshot AI)
|
||||||
|
**Strengths:** High-volume feature generation, rapid expansion, large context.
|
||||||
|
|
||||||
|
**Best for:**
|
||||||
|
- Big feature drops (new pages, new subsystems, new agent personas)
|
||||||
|
- Implementing the roadmap items listed below
|
||||||
|
- Generating boilerplate for new agents (Echo, Mace, Helm, Seer, Forge, Quill)
|
||||||
|
|
||||||
|
**Conventions to follow:**
|
||||||
|
- Deliver working code with accompanying tests (even if minimal)
|
||||||
|
- Match the dark Mission Control CSS theme — extend `static/style.css`
|
||||||
|
- New agents should follow the `SwarmNode` + `Registry` pattern in `src/swarm/`
|
||||||
|
- Lightning-gated endpoints follow the L402 pattern in `src/timmy_serve/l402_proxy.py`
|
||||||
|
|
||||||
|
**Avoid:**
|
||||||
|
- Touching CI/CD or pyproject.toml without coordinating
|
||||||
|
- Adding cloud API calls
|
||||||
|
- Removing existing tests
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Manus AI
|
||||||
|
**Strengths:** Precision security work, targeted bug fixes, coverage gap analysis.
|
||||||
|
|
||||||
|
**Best for:**
|
||||||
|
- Security audits (XSS, injection, secret exposure)
|
||||||
|
- Closing test coverage gaps for existing modules
|
||||||
|
- Performance profiling of specific endpoints
|
||||||
|
- Validating L402/Lightning payment flows
|
||||||
|
|
||||||
|
**Conventions to follow:**
|
||||||
|
- Scope tightly — one security issue per PR
|
||||||
|
- Every security fix must have a regression test
|
||||||
|
- Use `pytest-cov` output to identify gaps before writing new tests
|
||||||
|
- Document the vulnerability class in the PR description
|
||||||
|
|
||||||
|
**Avoid:**
|
||||||
|
- Large-scale refactors (that's Claude's lane)
|
||||||
|
- New feature work (that's Kimi's lane)
|
||||||
|
- Changing agent personas or prompt content
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. Architecture Patterns
|
||||||
|
|
||||||
|
### Singletons (module-level instances)
|
||||||
|
These are shared state — import them, don't recreate them:
|
||||||
|
```python
|
||||||
|
from dashboard.store import message_log # MessageLog
|
||||||
|
from notifications.push import notifier # PushNotifier
|
||||||
|
from websocket.handler import ws_manager # WebSocketManager
|
||||||
|
from timmy_serve.payment_handler import payment_handler # PaymentHandler
|
||||||
|
from swarm.coordinator import coordinator # SwarmCoordinator
|
||||||
|
```
|
||||||
|
|
||||||
|
### Config access
|
||||||
|
```python
|
||||||
|
from config import settings
|
||||||
|
url = settings.ollama_url # never os.environ.get() directly in route files
|
||||||
|
```
|
||||||
|
|
||||||
|
### HTMX pattern
|
||||||
|
Server renders HTML fragments. Routes return `TemplateResponse` with a partial
|
||||||
|
template. JS is minimal — no React, no Vue.
|
||||||
|
```python
|
||||||
|
return templates.TemplateResponse(
|
||||||
|
"partials/chat_message.html",
|
||||||
|
{"request": request, "role": "user", "content": message}
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
### Graceful degradation
|
||||||
|
```python
|
||||||
|
try:
|
||||||
|
result = await some_optional_service()
|
||||||
|
except Exception:
|
||||||
|
result = fallback_value # log, don't crash
|
||||||
|
```
|
||||||
|
|
||||||
|
### Tests
|
||||||
|
- All heavy deps (`agno`, `airllm`, `pyttsx3`) are stubbed in `tests/conftest.py`
|
||||||
|
- Use `pytest.fixture` for shared state; prefer function scope
|
||||||
|
- Use `TestClient` from `fastapi.testclient` for route tests
|
||||||
|
- No real Ollama required — mock `agent.run()`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. Running Locally
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make install # create venv + install dev deps
|
||||||
|
make test # run full test suite
|
||||||
|
make dev # start dashboard (http://localhost:8000)
|
||||||
|
make watch # self-TDD watchdog (background, 60s interval)
|
||||||
|
make test-cov # coverage report
|
||||||
|
```
|
||||||
|
|
||||||
|
Or manually:
|
||||||
|
```bash
|
||||||
|
python3 -m venv .venv && source .venv/bin/activate
|
||||||
|
pip install -e ".[dev]"
|
||||||
|
pytest # all 228 tests
|
||||||
|
uvicorn dashboard.app:app --reload --host 0.0.0.0 --port 8000
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. Roadmap (v2 → v3)
|
||||||
|
|
||||||
|
These are unbuilt items — claim one per PR, coordinate via Issues:
|
||||||
|
|
||||||
|
**v2.0.0 — Exodus (in progress)**
|
||||||
|
- [ ] Implement Echo, Mace, Helm, Seer, Forge, Quill agent personas as Agno agents
|
||||||
|
- [ ] Real LND gRPC backend for `PaymentHandler` (replace mock)
|
||||||
|
- [ ] MCP tool integration for Timmy
|
||||||
|
- [ ] Marketplace frontend — wire up the existing `/marketplace` route to real data
|
||||||
|
- [ ] Persistent swarm state across restarts (currently in-memory)
|
||||||
|
|
||||||
|
**v3.0.0 — Revelation (planned)**
|
||||||
|
- [ ] Bitcoin Lightning treasury (agent earns and spends sats autonomously)
|
||||||
|
- [ ] Single `.app` bundle for macOS (no Python install required)
|
||||||
|
- [ ] Federation — multiple Timmy instances discover and bid on each other's tasks
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. File Conventions
|
||||||
|
|
||||||
|
| Pattern | Convention |
|
||||||
|
|---------|-----------|
|
||||||
|
| New route | `src/dashboard/routes/<name>.py` + register in `app.py` |
|
||||||
|
| New template | `src/dashboard/templates/<name>.html` extends `base.html` |
|
||||||
|
| New partial | `src/dashboard/templates/partials/<name>.html` |
|
||||||
|
| New subsystem | `src/<name>/` with `__init__.py` |
|
||||||
|
| New test file | `tests/test_<module>.py` |
|
||||||
|
| Secrets | Read via `os.environ.get("VAR", "default")` + startup warning if default |
|
||||||
|
| DB files | `.db` files go in project root or `data/` — never in `src/` |
|
||||||
@@ -1,71 +0,0 @@
|
|||||||
# Timmy Time Dashboard: Development Report
|
|
||||||
|
|
||||||
**Author:** Manus AI
|
|
||||||
**Date:** 2026-02-21
|
|
||||||
|
|
||||||
## 1. Introduction
|
|
||||||
|
|
||||||
This report details the comprehensive development work undertaken to advance the Timmy Time Dashboard project. The initial request was to provide assistance with the project hosted on GitHub. After a thorough analysis of the repository and the provided bootstrap documentation, a significant gap was identified between the existing v1.0.0 codebase and the envisioned feature set. This project focused on bridging that gap by implementing all missing subsystems, adhering to a strict Test-Driven Development (TDD) methodology, and ensuring the final codebase is robust, well-tested, and aligned with the project's long-term vision.
|
|
||||||
|
|
||||||
## 2. Initial State Analysis
|
|
||||||
|
|
||||||
The initial repository at `v1.0.0` was a clean, well-structured foundation with a passing test suite of 61 tests. However, it represented only a small fraction of the functionality described in the bootstrap document. The core `TimmyAirLLMAgent` was present, along with a basic FastAPI dashboard, but the more advanced and economically significant features were entirely absent.
|
|
||||||
|
|
||||||
### Key Missing Components:
|
|
||||||
|
|
||||||
* **Swarm Subsystem:** The entire multi-agent coordination system, including the registry, manager, bidder, and task coordinator, was not implemented.
|
|
||||||
* **Economic Layer (L402):** The Lightning Network-based payment and authentication system was missing.
|
|
||||||
* **Enhanced I/O:** Voice (TTS/NLU), push notifications, and Siri Shortcuts integration were not present.
|
|
||||||
* **Dashboard Expansion:** Routes for managing the swarm, a marketplace for agents, and WebSocket-based live updates were needed.
|
|
||||||
|
|
||||||
## 3. Development and Implementation
|
|
||||||
|
|
||||||
The development process was divided into several phases, focusing on building out each missing subsystem and then integrating them into a cohesive whole. A strict Test-Driven Development (TDD) approach was adopted to ensure code quality and correctness from the outset.
|
|
||||||
|
|
||||||
### 3.1. Test-Driven Development (TDD)
|
|
||||||
|
|
||||||
For all new functionality, a TDD workflow was followed:
|
|
||||||
|
|
||||||
1. **Write a Failing Test (Red):** A new test case was written to define the desired behavior of a feature that did not yet exist or was incorrect.
|
|
||||||
2. **Make the Test Pass (Green):** The minimum amount of code was written to make the failing test pass.
|
|
||||||
3. **Refactor:** The code was cleaned up and improved while ensuring all tests remained green.
|
|
||||||
|
|
||||||
This iterative process resulted in a comprehensive test suite of **228 passing tests**, providing high confidence in the stability and correctness of the new features.
|
|
||||||
|
|
||||||
### 3.2. New Modules and Features
|
|
||||||
|
|
||||||
The following table summarizes the new modules that were created and integrated into the project:
|
|
||||||
|
|
||||||
| Module | Path | Description |
|
|
||||||
| ----------------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------- |
|
|
||||||
| **Swarm** | `src/swarm/` | The core multi-agent system for task coordination, bidding, and execution. |
|
|
||||||
| **L402/Lightning**| `src/timmy_serve/` | Implements the L402 protocol for gating API access with Bitcoin Lightning payments. |
|
|
||||||
| **Voice** | `src/voice/` & `src/timmy_serve/` | Provides Natural Language Understanding (NLU) for intent detection and Text-to-Speech (TTS) for output. |
|
|
||||||
| **Notifications** | `src/notifications/` | A local push notification system for swarm events. |
|
|
||||||
| **Shortcuts** | `src/shortcuts/` | API endpoints for integration with Apple's Siri Shortcuts. |
|
|
||||||
| **WebSocket** | `src/websocket/` | Manages real-time WebSocket connections for the live dashboard. |
|
|
||||||
| **Dashboard Routes**| `src/dashboard/routes/` | New FastAPI routes to expose the functionality of the new subsystems. |
|
|
||||||
|
|
||||||
### 3.3. Bug Fixes and Refinements
|
|
||||||
|
|
||||||
During the TDD process, several minor bugs and areas for improvement were identified and addressed:
|
|
||||||
|
|
||||||
* **NLU Entity Extraction:** The regular expression for extracting agent names was refined to correctly handle different phrasing (e.g., "spawn agent Echo" vs. "spawn Echo").
|
|
||||||
* **Test Mocking Paths:** An incorrect patch path in a mobile test was corrected to ensure the test ran reliably.
|
|
||||||
* **Dependency Management:** The `pyproject.toml` file was updated to include all new modules and optional dependencies for the swarm and voice features.
|
|
||||||
|
|
||||||
## 4. Final Test Results
|
|
||||||
|
|
||||||
The final test suite was executed, and all **228 tests passed successfully**. This represents a significant increase from the initial 61 tests and covers all new functionality, including the swarm subsystem, L402 proxy, voice NLU, and all new dashboard routes.
|
|
||||||
|
|
||||||
## 5. Conclusion and Next Steps
|
|
||||||
|
|
||||||
The Timmy Time Dashboard project has been significantly advanced from its initial state to a feature-rich platform that aligns with the bootstrap vision. The implementation of the swarm, economic layer, and enhanced I/O modules provides a solid foundation for a sovereign, economically independent AI agent system.
|
|
||||||
|
|
||||||
The codebase is now well-tested and ready for further development. The next logical steps would be to:
|
|
||||||
|
|
||||||
* Implement the planned agent personas (Echo, Mace, etc.) as fully functional `Agno` agents.
|
|
||||||
* Integrate a real LND gRPC backend for the `PaymentHandler`.
|
|
||||||
* Build out the front-end of the dashboard to visualize and interact with the new swarm and marketplace features.
|
|
||||||
|
|
||||||
This development effort has transformed the Timmy Time Dashboard from a concept into a tangible, working system, ready for the next stage of its evolution.
|
|
||||||
69
Makefile
Normal file
69
Makefile
Normal file
@@ -0,0 +1,69 @@
|
|||||||
|
.PHONY: install install-bigbrain dev test test-cov watch lint clean help
|
||||||
|
|
||||||
|
VENV := .venv
|
||||||
|
PYTHON := $(VENV)/bin/python
|
||||||
|
PIP := $(VENV)/bin/pip
|
||||||
|
PYTEST := $(VENV)/bin/pytest
|
||||||
|
UVICORN := $(VENV)/bin/uvicorn
|
||||||
|
SELF_TDD := $(VENV)/bin/self-tdd
|
||||||
|
|
||||||
|
# ── Setup ─────────────────────────────────────────────────────────────────────
|
||||||
|
|
||||||
|
install: $(VENV)/bin/activate
|
||||||
|
$(PIP) install --quiet -e ".[dev]"
|
||||||
|
@echo "✓ Ready. Run 'make dev' to start the dashboard."
|
||||||
|
|
||||||
|
install-bigbrain: $(VENV)/bin/activate
|
||||||
|
$(PIP) install --quiet -e ".[dev,bigbrain]"
|
||||||
|
@if [ "$$(uname -m)" = "arm64" ] && [ "$$(uname -s)" = "Darwin" ]; then \
|
||||||
|
$(PIP) install --quiet "airllm[mlx]"; \
|
||||||
|
echo "✓ AirLLM + MLX installed (Apple Silicon detected)"; \
|
||||||
|
else \
|
||||||
|
echo "✓ AirLLM installed (PyTorch backend)"; \
|
||||||
|
fi
|
||||||
|
|
||||||
|
$(VENV)/bin/activate:
|
||||||
|
python3 -m venv $(VENV)
|
||||||
|
|
||||||
|
# ── Development ───────────────────────────────────────────────────────────────
|
||||||
|
|
||||||
|
dev:
|
||||||
|
$(UVICORN) dashboard.app:app --reload --host 0.0.0.0 --port 8000
|
||||||
|
|
||||||
|
watch:
|
||||||
|
$(SELF_TDD) watch --interval 60
|
||||||
|
|
||||||
|
# ── Testing ───────────────────────────────────────────────────────────────────
|
||||||
|
|
||||||
|
test:
|
||||||
|
$(PYTEST) tests/ -q --tb=short
|
||||||
|
|
||||||
|
test-cov:
|
||||||
|
$(PYTEST) tests/ --cov=src --cov-report=term-missing --cov-report=xml -q
|
||||||
|
|
||||||
|
# ── Code quality ──────────────────────────────────────────────────────────────
|
||||||
|
|
||||||
|
lint:
|
||||||
|
@$(PYTHON) -m ruff check src/ tests/ 2>/dev/null || \
|
||||||
|
$(PYTHON) -m flake8 src/ tests/ 2>/dev/null || \
|
||||||
|
echo "No linter installed — run: pip install ruff"
|
||||||
|
|
||||||
|
# ── Housekeeping ──────────────────────────────────────────────────────────────
|
||||||
|
|
||||||
|
clean:
|
||||||
|
find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
|
||||||
|
find . -type d -name "*.egg-info" -exec rm -rf {} + 2>/dev/null || true
|
||||||
|
find . -name "*.pyc" -delete 2>/dev/null || true
|
||||||
|
rm -rf .pytest_cache htmlcov .coverage coverage.xml
|
||||||
|
|
||||||
|
help:
|
||||||
|
@echo ""
|
||||||
|
@echo " make install create venv + install dev deps"
|
||||||
|
@echo " make install-bigbrain install with AirLLM (big-model backend)"
|
||||||
|
@echo " make dev start dashboard at http://localhost:8000"
|
||||||
|
@echo " make test run all 228 tests"
|
||||||
|
@echo " make test-cov tests + coverage report"
|
||||||
|
@echo " make watch self-TDD watchdog (60s poll)"
|
||||||
|
@echo " make lint run ruff or flake8"
|
||||||
|
@echo " make clean remove build artefacts and caches"
|
||||||
|
@echo ""
|
||||||
365
README.md
365
README.md
@@ -2,274 +2,249 @@
|
|||||||
|
|
||||||
[](https://github.com/Alexspayne/Timmy-time-dashboard/actions/workflows/tests.yml)
|
[](https://github.com/Alexspayne/Timmy-time-dashboard/actions/workflows/tests.yml)
|
||||||
|
|
||||||
A local-first dashboard for your sovereign AI agents. Talk to Timmy, watch his status, verify Ollama is running — all from a browser, no cloud required.
|
A local-first, sovereign AI agent system. Talk to Timmy, watch his swarm, gate API access with Bitcoin Lightning — all from a browser, no cloud required.
|
||||||
|
|
||||||
|
**[Live Docs →](https://alexspayne.github.io/Timmy-time-dashboard/)**
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## What's built
|
||||||
|
|
||||||
|
| Subsystem | Description |
|
||||||
|
|-----------|-------------|
|
||||||
|
| **Timmy Agent** | Agno-powered agent (Ollama default, AirLLM optional for 70B/405B) |
|
||||||
|
| **Mission Control** | FastAPI + HTMX dashboard — chat, health, swarm, marketplace |
|
||||||
|
| **Swarm** | Multi-agent coordinator — spawn agents, post tasks, run Lightning auctions |
|
||||||
|
| **L402 / Lightning** | Bitcoin Lightning payment gating for API access |
|
||||||
|
| **Voice** | NLU intent detection + TTS (pyttsx3, no cloud) |
|
||||||
|
| **WebSocket** | Real-time swarm live feed |
|
||||||
|
| **Mobile** | Responsive layout with full iOS safe-area and touch support |
|
||||||
|
| **CLI** | `timmy`, `timmy-serve`, `self-tdd` entry points |
|
||||||
|
|
||||||
|
**228 tests, 100% passing.**
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Prerequisites
|
## Prerequisites
|
||||||
|
|
||||||
You need three things on your Mac before anything else:
|
|
||||||
|
|
||||||
**Python 3.11+**
|
**Python 3.11+**
|
||||||
```bash
|
```bash
|
||||||
python3 --version # should be 3.11 or higher
|
python3 --version # must be 3.11+
|
||||||
```
|
```
|
||||||
If not: `brew install python@3.11`
|
If not: `brew install python@3.11`
|
||||||
|
|
||||||
**Ollama** (runs the local LLM)
|
**Ollama** — runs the local LLM
|
||||||
```bash
|
```bash
|
||||||
brew install ollama
|
brew install ollama
|
||||||
|
# or download from https://ollama.com
|
||||||
```
|
```
|
||||||
Or download from https://ollama.com
|
|
||||||
|
|
||||||
**Git** — already on every Mac.
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Quickstart (copy-paste friendly)
|
## Quickstart
|
||||||
|
|
||||||
### 1. Clone the branch
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git clone -b claude/run-tests-IYl0F https://github.com/Alexspayne/Timmy-time-dashboard.git
|
# 1. Clone
|
||||||
|
git clone https://github.com/Alexspayne/Timmy-time-dashboard.git
|
||||||
cd Timmy-time-dashboard
|
cd Timmy-time-dashboard
|
||||||
```
|
|
||||||
|
|
||||||
### 2. Create a virtual environment and install
|
# 2. Install
|
||||||
|
make install
|
||||||
|
# or manually: python3 -m venv .venv && source .venv/bin/activate && pip install -e ".[dev]"
|
||||||
|
|
||||||
```bash
|
# 3. Start Ollama (separate terminal)
|
||||||
python3 -m venv .venv
|
|
||||||
source .venv/bin/activate
|
|
||||||
pip install -e ".[dev]"
|
|
||||||
```
|
|
||||||
|
|
||||||
### 3. Pull the model (one-time, ~2 GB download)
|
|
||||||
|
|
||||||
Open a **new terminal tab** and run:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
ollama serve
|
ollama serve
|
||||||
```
|
|
||||||
|
|
||||||
Back in your first tab:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
ollama pull llama3.2
|
ollama pull llama3.2
|
||||||
```
|
|
||||||
|
|
||||||
### 4. Start the dashboard
|
# 4. Launch dashboard
|
||||||
|
make dev
|
||||||
```bash
|
# opens at http://localhost:8000
|
||||||
uvicorn dashboard.app:app --reload
|
|
||||||
```
|
|
||||||
|
|
||||||
Open your browser to **http://localhost:8000**
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Access from your phone
|
|
||||||
|
|
||||||
The dashboard is mobile-optimized. To open it on your phone:
|
|
||||||
|
|
||||||
**Step 1 — bind to your local network** (instead of just localhost):
|
|
||||||
|
|
||||||
```bash
|
|
||||||
uvicorn dashboard.app:app --host 0.0.0.0 --port 8000 --reload
|
|
||||||
```
|
|
||||||
|
|
||||||
**Step 2 — find your Mac's IP address:**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
ipconfig getifaddr en0
|
|
||||||
```
|
|
||||||
|
|
||||||
This prints something like `192.168.1.42`. If you're on ethernet instead of Wi-Fi, try `en1`.
|
|
||||||
|
|
||||||
**Step 3 — open on your phone:**
|
|
||||||
|
|
||||||
Make sure your phone is on the **same Wi-Fi network** as your Mac, then open:
|
|
||||||
|
|
||||||
```
|
|
||||||
http://192.168.1.42:8000
|
|
||||||
```
|
|
||||||
|
|
||||||
(replace with your actual IP)
|
|
||||||
|
|
||||||
On mobile the layout switches to a single column — status panels become a horizontal scroll strip at the top, chat fills the rest of the screen. The input field is sized to prevent iOS from zooming in when you tap it.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## What you'll see
|
|
||||||
|
|
||||||
The dashboard has two panels on the left and a chat window on the right:
|
|
||||||
|
|
||||||
- **AGENTS** — Timmy's metadata (model, type, version)
|
|
||||||
- **SYSTEM HEALTH** — live Ollama status, auto-refreshes every 30 seconds
|
|
||||||
- **TIMMY INTERFACE** — type a message, hit SEND, get a response from the local LLM
|
|
||||||
|
|
||||||
If Ollama isn't running when you send a message, the chat will show a "Timmy is offline" error instead of crashing.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Run the tests
|
|
||||||
|
|
||||||
No Ollama needed — all external calls are mocked.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
pytest
|
|
||||||
```
|
|
||||||
|
|
||||||
Expected output:
|
|
||||||
```
|
|
||||||
27 passed in 0.67s
|
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Optional: CLI
|
## Common commands
|
||||||
|
|
||||||
With your venv active:
|
```bash
|
||||||
|
make test # run all 228 tests (no Ollama needed)
|
||||||
|
make test-cov # test + coverage report
|
||||||
|
make dev # start dashboard (http://localhost:8000)
|
||||||
|
make watch # self-TDD watchdog (60s poll, alerts on regressions)
|
||||||
|
```
|
||||||
|
|
||||||
|
Or with the bootstrap script (creates venv, tests, watchdog, server in one shot):
|
||||||
|
```bash
|
||||||
|
bash activate_self_tdd.sh
|
||||||
|
bash activate_self_tdd.sh --big-brain # also installs AirLLM
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## CLI
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
timmy chat "What is sovereignty?"
|
timmy chat "What is sovereignty?"
|
||||||
timmy think "Bitcoin and self-custody"
|
timmy think "Bitcoin and self-custody"
|
||||||
timmy status
|
timmy status
|
||||||
|
|
||||||
|
timmy-serve start # L402-gated API server (port 8402)
|
||||||
|
timmy-serve invoice # generate a Lightning invoice
|
||||||
|
timmy-serve status
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Big Brain — AirLLM backend (Apple Silicon / large RAM)
|
## Mobile access
|
||||||
|
|
||||||
Run 70B or 405B models locally with no GPU required, using AirLLM's
|
The dashboard is fully mobile-optimized (iOS safe area, 44px touch targets, 16px
|
||||||
layer-by-layer loading strategy. On M-series Macs the MLX backend is
|
input to prevent zoom, momentum scroll).
|
||||||
selected automatically for maximum throughput. Everything stays local.
|
|
||||||
No cloud. No telemetry. Sats are sovereignty, boss.
|
|
||||||
|
|
||||||
### One-line install
|
```bash
|
||||||
|
# Bind to your local network
|
||||||
|
uvicorn dashboard.app:app --host 0.0.0.0 --port 8000 --reload
|
||||||
|
|
||||||
|
# Find your IP
|
||||||
|
ipconfig getifaddr en0 # Wi-Fi on macOS
|
||||||
|
```
|
||||||
|
|
||||||
|
Open `http://<your-ip>:8000` on your phone (same Wi-Fi network).
|
||||||
|
|
||||||
|
Mobile-specific routes:
|
||||||
|
- `/mobile` — single-column optimized layout
|
||||||
|
- `/mobile-test` — 21-scenario HITL test harness (layout, touch, scroll, notch)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## AirLLM — big brain backend
|
||||||
|
|
||||||
|
Run 70B or 405B models locally with no GPU, using AirLLM's layer-by-layer loading.
|
||||||
|
Apple Silicon uses MLX automatically.
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
pip install ".[bigbrain]"
|
pip install ".[bigbrain]"
|
||||||
# Apple Silicon only — adds the MLX-accelerated backend:
|
pip install "airllm[mlx]" # Apple Silicon only
|
||||||
pip install "airllm[mlx]"
|
|
||||||
|
timmy chat "Explain self-custody" --backend airllm --model-size 70b
|
||||||
```
|
```
|
||||||
|
|
||||||
### Run with the big brain
|
Or set once in `.env`:
|
||||||
|
```bash
|
||||||
|
TIMMY_MODEL_BACKEND=auto
|
||||||
|
AIRLLM_MODEL_SIZE=70b
|
||||||
|
```
|
||||||
|
|
||||||
|
| Flag | Parameters | RAM needed |
|
||||||
|
|-------|-------------|------------|
|
||||||
|
| `8b` | 8 billion | ~16 GB |
|
||||||
|
| `70b` | 70 billion | ~140 GB |
|
||||||
|
| `405b`| 405 billion | ~810 GB |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Explicit flag — works anywhere airllm is installed:
|
cp .env.example .env
|
||||||
timmy chat "Explain self-custody" --backend airllm --model-size 70b
|
# edit .env
|
||||||
|
|
||||||
# Or set it once in .env and forget about it:
|
|
||||||
echo "TIMMY_MODEL_BACKEND=auto" >> .env
|
|
||||||
echo "AIRLLM_MODEL_SIZE=70b" >> .env
|
|
||||||
timmy chat "What is sovereignty?"
|
|
||||||
```
|
```
|
||||||
|
|
||||||
`--backend auto` (or `TIMMY_MODEL_BACKEND=auto`) selects AirLLM automatically
|
| Variable | Default | Purpose |
|
||||||
on Apple Silicon when the package is installed, and falls back to Ollama
|
|----------|---------|---------|
|
||||||
everywhere else — so the same `.env` works on any machine.
|
| `OLLAMA_URL` | `http://localhost:11434` | Ollama host |
|
||||||
|
| `OLLAMA_MODEL` | `llama3.2` | Model served by Ollama |
|
||||||
### Model sizes
|
| `DEBUG` | `false` | Enable `/docs` and `/redoc` |
|
||||||
|
| `TIMMY_MODEL_BACKEND` | `ollama` | `ollama` \| `airllm` \| `auto` |
|
||||||
| Flag | Parameters | Approx. RAM needed |
|
| `AIRLLM_MODEL_SIZE` | `70b` | `8b` \| `70b` \| `405b` |
|
||||||
|------|-----------|-------------------|
|
| `L402_HMAC_SECRET` | *(default — change in prod)* | HMAC signing key for macaroons |
|
||||||
| `8b` | 8 billion | ~16 GB |
|
| `L402_MACAROON_SECRET` | *(default — change in prod)* | Macaroon secret |
|
||||||
| `70b` | 70 billion | ~140 GB |
|
| `LIGHTNING_BACKEND` | `mock` | `mock` \| `lnd` |
|
||||||
| `405b` | 405 billion | ~810 GB |
|
|
||||||
|
|
||||||
Models are downloaded from HuggingFace on first run and cached locally.
|
|
||||||
You need a HuggingFace account and `huggingface-cli login` for gated models
|
|
||||||
(Llama 3.1 requires accepting Meta's license at hf.co/meta-llama).
|
|
||||||
|
|
||||||
### Architecture with AirLLM
|
|
||||||
|
|
||||||
```
|
|
||||||
timmy chat --backend airllm
|
|
||||||
│
|
|
||||||
▼
|
|
||||||
TimmyAirLLMAgent (src/timmy/backends.py)
|
|
||||||
│
|
|
||||||
├─ Apple Silicon? ──► AirLLMMLX (MLX tensors, Metal GPU)
|
|
||||||
└─ Everything else ──► AutoModel (PyTorch, CPU/CUDA)
|
|
||||||
│
|
|
||||||
└─ Layers loaded on-demand from ~/.cache/huggingface/
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Architecture
|
## Architecture
|
||||||
|
|
||||||
```mermaid
|
```
|
||||||
graph TD
|
Browser / Phone
|
||||||
Phone["📱 Phone / Browser"]
|
│ HTTP + HTMX + WebSocket
|
||||||
Browser["💻 Browser"]
|
▼
|
||||||
|
┌─────────────────────────────────────────┐
|
||||||
|
│ FastAPI (dashboard.app) │
|
||||||
|
│ routes: agents, health, swarm, │
|
||||||
|
│ marketplace, voice, mobile │
|
||||||
|
└───┬─────────────┬──────────┬────────────┘
|
||||||
|
│ │ │
|
||||||
|
▼ ▼ ▼
|
||||||
|
Jinja2 Timmy Swarm
|
||||||
|
Templates Agent Coordinator
|
||||||
|
(HTMX) │ ├─ Registry (SQLite)
|
||||||
|
├─ Ollama ├─ AuctionManager (L402 bids)
|
||||||
|
└─ AirLLM ├─ SwarmComms (Redis / in-memory)
|
||||||
|
└─ SwarmManager (subprocess)
|
||||||
|
│
|
||||||
|
├── Voice NLU + TTS (pyttsx3, local)
|
||||||
|
├── WebSocket live feed (ws_manager)
|
||||||
|
├── L402 Lightning proxy (macaroon + invoice)
|
||||||
|
├── Push notifications (local + macOS native)
|
||||||
|
└── Siri Shortcuts API endpoints
|
||||||
|
|
||||||
Phone -->|HTTP + HTMX| FastAPI
|
Persistence: timmy.db (Agno memory), data/swarm.db (registry + tasks)
|
||||||
Browser -->|HTTP + HTMX| FastAPI
|
External: Ollama :11434, optional Redis, optional LND gRPC
|
||||||
|
|
||||||
subgraph "Local Machine"
|
|
||||||
FastAPI["FastAPI\n(dashboard.app)"]
|
|
||||||
Jinja["Jinja2 Templates\n+ static CSS"]
|
|
||||||
Timmy["Timmy Agent\n(Agno wrapper)"]
|
|
||||||
Ollama["Ollama\n:11434"]
|
|
||||||
SQLite[("SQLite\ntimmy.db")]
|
|
||||||
|
|
||||||
FastAPI -->|renders| Jinja
|
|
||||||
FastAPI -->|/agents/timmy/chat| Timmy
|
|
||||||
FastAPI -->|/health/status ping| Ollama
|
|
||||||
Timmy -->|LLM call| Ollama
|
|
||||||
Timmy -->|conversation memory| SQLite
|
|
||||||
end
|
|
||||||
```
|
```
|
||||||
|
|
||||||
All traffic stays on your local network. No cloud, no telemetry.
|
---
|
||||||
|
|
||||||
## Configuration
|
|
||||||
|
|
||||||
Override defaults without touching code — create a `.env` file (see `.env.example`):
|
|
||||||
|
|
||||||
```bash
|
|
||||||
cp .env.example .env
|
|
||||||
# then edit .env
|
|
||||||
```
|
|
||||||
|
|
||||||
| Variable | Default | Purpose |
|
|
||||||
|---|---|---|
|
|
||||||
| `OLLAMA_URL` | `http://localhost:11434` | Ollama host (useful if Ollama runs on another machine) |
|
|
||||||
| `OLLAMA_MODEL` | `llama3.2` | LLM model served by Ollama |
|
|
||||||
| `DEBUG` | `false` | Set `true` to enable `/docs` and `/redoc` |
|
|
||||||
|
|
||||||
## Project layout
|
## Project layout
|
||||||
|
|
||||||
```
|
```
|
||||||
src/
|
src/
|
||||||
config.py # pydantic-settings (reads .env)
|
config.py # pydantic-settings — all env vars live here
|
||||||
timmy/ # Timmy agent — wraps Agno (soul = prompt, body = Agno)
|
timmy/ # Core agent (agent.py, backends.py, cli.py, prompts.py)
|
||||||
dashboard/ # FastAPI app + routes + Jinja2 templates
|
dashboard/ # FastAPI app, routes, Jinja2 templates
|
||||||
static/ # CSS (dark mission-control theme)
|
swarm/ # Multi-agent: coordinator, registry, bidder, tasks, comms
|
||||||
tests/ # pytest suite (27 tests, no Ollama required)
|
timmy_serve/ # L402 proxy, payment handler, TTS, serve CLI
|
||||||
.env.example # environment variable reference
|
voice/ # NLU intent detection
|
||||||
pyproject.toml # dependencies and build config
|
websocket/ # WebSocket connection manager
|
||||||
|
notifications/ # Push notification store
|
||||||
|
shortcuts/ # Siri Shortcuts endpoints
|
||||||
|
self_tdd/ # Continuous test watchdog
|
||||||
|
tests/ # 228 tests — one file per module, all mocked
|
||||||
|
static/style.css # Dark mission-control theme (JetBrains Mono)
|
||||||
|
docs/ # GitHub Pages landing page
|
||||||
|
AGENTS.md # AI agent development standards ← read this
|
||||||
|
.env.example # Environment variable reference
|
||||||
|
Makefile # Common dev commands
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Troubleshooting
|
## Troubleshooting
|
||||||
|
|
||||||
**`ollama: command not found`** — Ollama isn't installed or isn't on your PATH. Install via Homebrew or the .dmg from ollama.com.
|
**`ollama: command not found`** — install from `brew install ollama` or ollama.com
|
||||||
|
|
||||||
**`connection refused` in the chat** — Ollama isn't running. Open a terminal and run `ollama serve`, then try again.
|
**`connection refused` in chat** — run `ollama serve` in a separate terminal
|
||||||
|
|
||||||
**`ModuleNotFoundError: No module named 'dashboard'`** — You're not in the venv or forgot `pip install -e .`. Run `source .venv/bin/activate` then `pip install -e ".[dev]"`.
|
**`ModuleNotFoundError: No module named 'dashboard'`** — activate the venv:
|
||||||
|
`source .venv/bin/activate && pip install -e ".[dev]"`
|
||||||
|
|
||||||
**Health panel shows DOWN** — Ollama isn't running. The chat still works for testing but will return the offline error message.
|
**Health panel shows DOWN** — Ollama isn't running; chat still works but returns
|
||||||
|
the offline error message
|
||||||
|
|
||||||
|
**L402 startup warnings** — set `L402_HMAC_SECRET` and `L402_MACAROON_SECRET` in
|
||||||
|
`.env` to silence them (required for production)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## For AI agents contributing to this repo
|
||||||
|
|
||||||
|
Read [`AGENTS.md`](AGENTS.md). It covers per-agent assignments, architecture
|
||||||
|
patterns, coding conventions, and the v2→v3 roadmap.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Roadmap
|
## Roadmap
|
||||||
|
|
||||||
| Version | Name | Milestone |
|
| Version | Name | Status | Milestone |
|
||||||
|---------|------------|--------------------------------------------|
|
|---------|------------|-------------|-----------|
|
||||||
| 1.0.0 | Genesis | Agno + Ollama + SQLite + Dashboard |
|
| 1.0.0 | Genesis | ✅ Complete | Agno + Ollama + SQLite + Dashboard |
|
||||||
| 2.0.0 | Exodus | MCP tools + multi-agent |
|
| 2.0.0 | Exodus | 🔄 In progress | Swarm + L402 + Voice + Marketplace |
|
||||||
| 3.0.0 | Revelation | Bitcoin Lightning treasury + single `.app` |
|
| 3.0.0 | Revelation | 📋 Planned | Lightning treasury + single `.app` bundle |
|
||||||
|
|||||||
47
STATUS.md
47
STATUS.md
@@ -1,47 +0,0 @@
|
|||||||
# Timmy Time — Status
|
|
||||||
|
|
||||||
## Current Version: 1.0.0 (Genesis)
|
|
||||||
|
|
||||||
### What's Built
|
|
||||||
- `src/timmy/` — Agno-powered Timmy agent (llama3.2 via Ollama, SQLite memory)
|
|
||||||
- `src/dashboard/` — FastAPI Mission Control dashboard (HTMX + Jinja2)
|
|
||||||
- CLI: `timmy think / chat / status`
|
|
||||||
- Pytest test suite (prompts, agent config, dashboard routes)
|
|
||||||
|
|
||||||
### System Requirements
|
|
||||||
- Python 3.11+
|
|
||||||
- Ollama running at `http://localhost:11434`
|
|
||||||
- `llama3.2` model pulled
|
|
||||||
|
|
||||||
### Quickstart
|
|
||||||
```bash
|
|
||||||
pip install -e ".[dev]"
|
|
||||||
|
|
||||||
# Start Ollama (separate terminal)
|
|
||||||
ollama serve
|
|
||||||
ollama pull llama3.2
|
|
||||||
|
|
||||||
# Run dashboard
|
|
||||||
uvicorn dashboard.app:app --reload
|
|
||||||
|
|
||||||
# Run tests (no Ollama required)
|
|
||||||
pytest
|
|
||||||
```
|
|
||||||
|
|
||||||
### Dashboard
|
|
||||||
`http://localhost:8000` — Mission Control UI with:
|
|
||||||
- Timmy agent status panel
|
|
||||||
- Ollama health indicator (auto-refreshes every 30s)
|
|
||||||
- Live chat interface
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Roadmap
|
|
||||||
|
|
||||||
| Tag | Name | Milestone |
|
|
||||||
|-------|------------|----------------------------------------------|
|
|
||||||
| 1.0.0 | Genesis | Agno + Ollama + SQLite + Dashboard |
|
|
||||||
| 2.0.0 | Exodus | MCP tools + multi-agent support |
|
|
||||||
| 3.0.0 | Revelation | Bitcoin Lightning treasury + single `.app` |
|
|
||||||
|
|
||||||
_Last updated: 2026-02-19_
|
|
||||||
926
docs/index.html
Normal file
926
docs/index.html
Normal file
@@ -0,0 +1,926 @@
|
|||||||
|
<!DOCTYPE html>
|
||||||
|
<html lang="en">
|
||||||
|
<head>
|
||||||
|
<meta charset="UTF-8" />
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
|
||||||
|
<title>Timmy Time — Mission Control</title>
|
||||||
|
<link rel="preconnect" href="https://fonts.googleapis.com" />
|
||||||
|
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
|
||||||
|
<link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;600;700&display=swap" rel="stylesheet" />
|
||||||
|
<style>
|
||||||
|
/* ── Reset & base ────────────────────────────────────────────────────── */
|
||||||
|
*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
|
||||||
|
|
||||||
|
:root {
|
||||||
|
--bg-deep: #060d14;
|
||||||
|
--bg-panel: #0c1824;
|
||||||
|
--bg-card: #0f2030;
|
||||||
|
--border: #1a3a55;
|
||||||
|
--border-glow: #1e4d72;
|
||||||
|
--text: #b8d0e8;
|
||||||
|
--text-dim: #4a7a9a;
|
||||||
|
--text-bright: #ddeeff;
|
||||||
|
--green: #00e87a;
|
||||||
|
--amber: #ffb800;
|
||||||
|
--red: #ff4455;
|
||||||
|
--blue: #00aaff;
|
||||||
|
--purple: #aa77ff;
|
||||||
|
--font: 'JetBrains Mono', monospace;
|
||||||
|
}
|
||||||
|
|
||||||
|
html { scroll-behavior: smooth; }
|
||||||
|
|
||||||
|
body {
|
||||||
|
background: var(--bg-deep);
|
||||||
|
color: var(--text);
|
||||||
|
font-family: var(--font);
|
||||||
|
font-size: 14px;
|
||||||
|
line-height: 1.7;
|
||||||
|
min-height: 100vh;
|
||||||
|
overflow-x: hidden;
|
||||||
|
}
|
||||||
|
|
||||||
|
a { color: var(--blue); text-decoration: none; }
|
||||||
|
a:hover { text-decoration: underline; }
|
||||||
|
|
||||||
|
/* ── Scanline overlay ────────────────────────────────────────────────── */
|
||||||
|
body::before {
|
||||||
|
content: '';
|
||||||
|
position: fixed;
|
||||||
|
inset: 0;
|
||||||
|
background: repeating-linear-gradient(
|
||||||
|
0deg,
|
||||||
|
transparent,
|
||||||
|
transparent 2px,
|
||||||
|
rgba(0, 170, 255, 0.012) 2px,
|
||||||
|
rgba(0, 170, 255, 0.012) 4px
|
||||||
|
);
|
||||||
|
pointer-events: none;
|
||||||
|
z-index: 999;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ── Header ──────────────────────────────────────────────────────────── */
|
||||||
|
header {
|
||||||
|
border-bottom: 1px solid var(--border);
|
||||||
|
background: var(--bg-panel);
|
||||||
|
padding: 0 2rem;
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: space-between;
|
||||||
|
height: 56px;
|
||||||
|
position: sticky;
|
||||||
|
top: 0;
|
||||||
|
z-index: 100;
|
||||||
|
}
|
||||||
|
|
||||||
|
.logo {
|
||||||
|
font-size: 13px;
|
||||||
|
font-weight: 700;
|
||||||
|
color: var(--blue);
|
||||||
|
letter-spacing: 0.15em;
|
||||||
|
text-transform: uppercase;
|
||||||
|
}
|
||||||
|
|
||||||
|
.logo span { color: var(--text-dim); }
|
||||||
|
|
||||||
|
nav { display: flex; gap: 1.5rem; align-items: center; }
|
||||||
|
nav a {
|
||||||
|
color: var(--text-dim);
|
||||||
|
font-size: 12px;
|
||||||
|
letter-spacing: 0.08em;
|
||||||
|
text-transform: uppercase;
|
||||||
|
transition: color 0.2s;
|
||||||
|
}
|
||||||
|
nav a:hover { color: var(--blue); text-decoration: none; }
|
||||||
|
|
||||||
|
.btn-primary {
|
||||||
|
background: var(--blue);
|
||||||
|
color: #000;
|
||||||
|
font-family: var(--font);
|
||||||
|
font-size: 12px;
|
||||||
|
font-weight: 700;
|
||||||
|
letter-spacing: 0.08em;
|
||||||
|
text-transform: uppercase;
|
||||||
|
padding: 8px 18px;
|
||||||
|
border: none;
|
||||||
|
cursor: pointer;
|
||||||
|
transition: background 0.2s, box-shadow 0.2s;
|
||||||
|
display: inline-block;
|
||||||
|
}
|
||||||
|
.btn-primary:hover {
|
||||||
|
background: #33bbff;
|
||||||
|
box-shadow: 0 0 16px rgba(0, 170, 255, 0.4);
|
||||||
|
text-decoration: none;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ── Hero ────────────────────────────────────────────────────────────── */
|
||||||
|
.hero {
|
||||||
|
padding: 7rem 2rem 5rem;
|
||||||
|
text-align: center;
|
||||||
|
position: relative;
|
||||||
|
overflow: hidden;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero::before {
|
||||||
|
content: '';
|
||||||
|
position: absolute;
|
||||||
|
top: -80px;
|
||||||
|
left: 50%;
|
||||||
|
transform: translateX(-50%);
|
||||||
|
width: 600px;
|
||||||
|
height: 600px;
|
||||||
|
background: radial-gradient(circle, rgba(0, 170, 255, 0.08) 0%, transparent 70%);
|
||||||
|
pointer-events: none;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-label {
|
||||||
|
font-size: 11px;
|
||||||
|
letter-spacing: 0.25em;
|
||||||
|
color: var(--blue);
|
||||||
|
text-transform: uppercase;
|
||||||
|
margin-bottom: 1.5rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero h1 {
|
||||||
|
font-size: clamp(2rem, 6vw, 4.5rem);
|
||||||
|
font-weight: 700;
|
||||||
|
color: var(--text-bright);
|
||||||
|
letter-spacing: -0.02em;
|
||||||
|
line-height: 1.1;
|
||||||
|
margin-bottom: 1rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero h1 em {
|
||||||
|
font-style: normal;
|
||||||
|
color: var(--blue);
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-sub {
|
||||||
|
font-size: clamp(13px, 2vw, 16px);
|
||||||
|
color: var(--text-dim);
|
||||||
|
max-width: 560px;
|
||||||
|
margin: 0 auto 2.5rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-badges {
|
||||||
|
display: flex;
|
||||||
|
gap: 0.75rem;
|
||||||
|
justify-content: center;
|
||||||
|
flex-wrap: wrap;
|
||||||
|
margin-bottom: 2.5rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
.badge {
|
||||||
|
font-size: 11px;
|
||||||
|
letter-spacing: 0.05em;
|
||||||
|
padding: 4px 12px;
|
||||||
|
border: 1px solid var(--border-glow);
|
||||||
|
color: var(--text-dim);
|
||||||
|
background: var(--bg-panel);
|
||||||
|
}
|
||||||
|
|
||||||
|
.badge.green { border-color: var(--green); color: var(--green); }
|
||||||
|
.badge.amber { border-color: var(--amber); color: var(--amber); }
|
||||||
|
.badge.blue { border-color: var(--blue); color: var(--blue); }
|
||||||
|
.badge.purple { border-color: var(--purple); color: var(--purple); }
|
||||||
|
|
||||||
|
.hero-cta { display: flex; gap: 1rem; justify-content: center; flex-wrap: wrap; }
|
||||||
|
|
||||||
|
.btn-ghost {
|
||||||
|
border: 1px solid var(--border-glow);
|
||||||
|
color: var(--text);
|
||||||
|
font-family: var(--font);
|
||||||
|
font-size: 12px;
|
||||||
|
font-weight: 600;
|
||||||
|
letter-spacing: 0.08em;
|
||||||
|
text-transform: uppercase;
|
||||||
|
padding: 8px 18px;
|
||||||
|
background: transparent;
|
||||||
|
cursor: pointer;
|
||||||
|
transition: border-color 0.2s, color 0.2s;
|
||||||
|
display: inline-block;
|
||||||
|
}
|
||||||
|
.btn-ghost:hover {
|
||||||
|
border-color: var(--blue);
|
||||||
|
color: var(--blue);
|
||||||
|
text-decoration: none;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ── Stats bar ───────────────────────────────────────────────────────── */
|
||||||
|
.stats {
|
||||||
|
display: flex;
|
||||||
|
justify-content: center;
|
||||||
|
gap: 0;
|
||||||
|
border-top: 1px solid var(--border);
|
||||||
|
border-bottom: 1px solid var(--border);
|
||||||
|
background: var(--bg-panel);
|
||||||
|
}
|
||||||
|
|
||||||
|
.stat {
|
||||||
|
flex: 1;
|
||||||
|
max-width: 200px;
|
||||||
|
padding: 1.5rem 1rem;
|
||||||
|
text-align: center;
|
||||||
|
border-right: 1px solid var(--border);
|
||||||
|
}
|
||||||
|
.stat:last-child { border-right: none; }
|
||||||
|
|
||||||
|
.stat-number {
|
||||||
|
font-size: 2rem;
|
||||||
|
font-weight: 700;
|
||||||
|
color: var(--blue);
|
||||||
|
line-height: 1;
|
||||||
|
margin-bottom: 0.25rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
.stat-label {
|
||||||
|
font-size: 11px;
|
||||||
|
letter-spacing: 0.1em;
|
||||||
|
text-transform: uppercase;
|
||||||
|
color: var(--text-dim);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ── Section layout ──────────────────────────────────────────────────── */
|
||||||
|
section { padding: 5rem 2rem; max-width: 1100px; margin: 0 auto; }
|
||||||
|
|
||||||
|
.section-label {
|
||||||
|
font-size: 11px;
|
||||||
|
letter-spacing: 0.2em;
|
||||||
|
text-transform: uppercase;
|
||||||
|
color: var(--blue);
|
||||||
|
margin-bottom: 0.75rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
section h2 {
|
||||||
|
font-size: clamp(1.4rem, 3vw, 2.2rem);
|
||||||
|
font-weight: 700;
|
||||||
|
color: var(--text-bright);
|
||||||
|
margin-bottom: 1rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
.section-intro {
|
||||||
|
color: var(--text-dim);
|
||||||
|
max-width: 620px;
|
||||||
|
margin-bottom: 3rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ── Feature grid ────────────────────────────────────────────────────── */
|
||||||
|
.feature-grid {
|
||||||
|
display: grid;
|
||||||
|
grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
|
||||||
|
gap: 1px;
|
||||||
|
border: 1px solid var(--border);
|
||||||
|
background: var(--border);
|
||||||
|
}
|
||||||
|
|
||||||
|
.feature-card {
|
||||||
|
background: var(--bg-panel);
|
||||||
|
padding: 2rem;
|
||||||
|
transition: background 0.2s;
|
||||||
|
}
|
||||||
|
.feature-card:hover { background: var(--bg-card); }
|
||||||
|
|
||||||
|
.feature-icon {
|
||||||
|
font-size: 1.5rem;
|
||||||
|
margin-bottom: 1rem;
|
||||||
|
display: block;
|
||||||
|
}
|
||||||
|
|
||||||
|
.feature-card h3 {
|
||||||
|
font-size: 14px;
|
||||||
|
font-weight: 700;
|
||||||
|
color: var(--text-bright);
|
||||||
|
margin-bottom: 0.5rem;
|
||||||
|
letter-spacing: 0.05em;
|
||||||
|
text-transform: uppercase;
|
||||||
|
}
|
||||||
|
|
||||||
|
.feature-card p {
|
||||||
|
font-size: 13px;
|
||||||
|
color: var(--text-dim);
|
||||||
|
line-height: 1.6;
|
||||||
|
}
|
||||||
|
|
||||||
|
.feature-tag {
|
||||||
|
display: inline-block;
|
||||||
|
font-size: 10px;
|
||||||
|
letter-spacing: 0.08em;
|
||||||
|
text-transform: uppercase;
|
||||||
|
padding: 2px 8px;
|
||||||
|
margin-top: 0.75rem;
|
||||||
|
border: 1px solid var(--border);
|
||||||
|
color: var(--text-dim);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ── Architecture ────────────────────────────────────────────────────── */
|
||||||
|
.arch-wrap {
|
||||||
|
border: 1px solid var(--border);
|
||||||
|
background: var(--bg-panel);
|
||||||
|
padding: 2rem;
|
||||||
|
overflow-x: auto;
|
||||||
|
}
|
||||||
|
|
||||||
|
.arch-wrap pre {
|
||||||
|
font-family: var(--font);
|
||||||
|
font-size: 12px;
|
||||||
|
color: var(--text);
|
||||||
|
line-height: 1.6;
|
||||||
|
white-space: pre;
|
||||||
|
}
|
||||||
|
|
||||||
|
.arch-wrap pre .hl-blue { color: var(--blue); }
|
||||||
|
.arch-wrap pre .hl-green { color: var(--green); }
|
||||||
|
.arch-wrap pre .hl-amber { color: var(--amber); }
|
||||||
|
.arch-wrap pre .hl-purple { color: var(--purple); }
|
||||||
|
.arch-wrap pre .hl-dim { color: var(--text-dim); }
|
||||||
|
|
||||||
|
/* ── Quickstart ──────────────────────────────────────────────────────── */
|
||||||
|
.quickstart-steps { display: flex; flex-direction: column; gap: 1.5rem; }
|
||||||
|
|
||||||
|
.step {
|
||||||
|
display: grid;
|
||||||
|
grid-template-columns: 48px 1fr;
|
||||||
|
gap: 1.25rem;
|
||||||
|
align-items: start;
|
||||||
|
}
|
||||||
|
|
||||||
|
.step-num {
|
||||||
|
width: 48px;
|
||||||
|
height: 48px;
|
||||||
|
border: 1px solid var(--border-glow);
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
font-weight: 700;
|
||||||
|
color: var(--blue);
|
||||||
|
font-size: 16px;
|
||||||
|
flex-shrink: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.step h4 {
|
||||||
|
font-size: 13px;
|
||||||
|
font-weight: 700;
|
||||||
|
color: var(--text-bright);
|
||||||
|
margin-bottom: 0.5rem;
|
||||||
|
text-transform: uppercase;
|
||||||
|
letter-spacing: 0.05em;
|
||||||
|
}
|
||||||
|
|
||||||
|
.step p { font-size: 13px; color: var(--text-dim); margin-bottom: 0.5rem; }
|
||||||
|
|
||||||
|
code {
|
||||||
|
background: var(--bg-card);
|
||||||
|
border: 1px solid var(--border);
|
||||||
|
padding: 0.15em 0.5em;
|
||||||
|
font-family: var(--font);
|
||||||
|
font-size: 12px;
|
||||||
|
color: var(--green);
|
||||||
|
}
|
||||||
|
|
||||||
|
pre.codeblock {
|
||||||
|
background: var(--bg-card);
|
||||||
|
border: 1px solid var(--border);
|
||||||
|
padding: 1.25rem 1.5rem;
|
||||||
|
font-family: var(--font);
|
||||||
|
font-size: 12px;
|
||||||
|
color: var(--text);
|
||||||
|
line-height: 1.7;
|
||||||
|
overflow-x: auto;
|
||||||
|
margin-top: 0.5rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
pre.codeblock .cmd { color: var(--green); }
|
||||||
|
pre.codeblock .cmt { color: var(--text-dim); }
|
||||||
|
pre.codeblock .flag { color: var(--amber); }
|
||||||
|
|
||||||
|
/* ── Agent team ──────────────────────────────────────────────────────── */
|
||||||
|
.agent-grid {
|
||||||
|
display: grid;
|
||||||
|
grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
|
||||||
|
gap: 1px;
|
||||||
|
border: 1px solid var(--border);
|
||||||
|
background: var(--border);
|
||||||
|
}
|
||||||
|
|
||||||
|
.agent-card {
|
||||||
|
background: var(--bg-panel);
|
||||||
|
padding: 2rem;
|
||||||
|
position: relative;
|
||||||
|
}
|
||||||
|
|
||||||
|
.agent-accent {
|
||||||
|
position: absolute;
|
||||||
|
top: 0;
|
||||||
|
left: 0;
|
||||||
|
right: 0;
|
||||||
|
height: 2px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.agent-name {
|
||||||
|
font-size: 15px;
|
||||||
|
font-weight: 700;
|
||||||
|
color: var(--text-bright);
|
||||||
|
margin-bottom: 0.25rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
.agent-role {
|
||||||
|
font-size: 11px;
|
||||||
|
letter-spacing: 0.1em;
|
||||||
|
text-transform: uppercase;
|
||||||
|
color: var(--text-dim);
|
||||||
|
margin-bottom: 1.25rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
.agent-list {
|
||||||
|
list-style: none;
|
||||||
|
font-size: 12px;
|
||||||
|
color: var(--text-dim);
|
||||||
|
}
|
||||||
|
|
||||||
|
.agent-list li { padding: 0.2rem 0; }
|
||||||
|
.agent-list li::before { content: '→ '; color: var(--border-glow); }
|
||||||
|
|
||||||
|
/* ── Roadmap ─────────────────────────────────────────────────────────── */
|
||||||
|
.roadmap { display: flex; flex-direction: column; gap: 0; }
|
||||||
|
|
||||||
|
.roadmap-item {
|
||||||
|
display: grid;
|
||||||
|
grid-template-columns: 120px 1fr;
|
||||||
|
gap: 0;
|
||||||
|
border: 1px solid var(--border);
|
||||||
|
margin-top: -1px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.roadmap-version {
|
||||||
|
background: var(--bg-card);
|
||||||
|
border-right: 1px solid var(--border);
|
||||||
|
padding: 1.5rem 1.25rem;
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
justify-content: center;
|
||||||
|
}
|
||||||
|
|
||||||
|
.roadmap-ver-num {
|
||||||
|
font-weight: 700;
|
||||||
|
color: var(--blue);
|
||||||
|
font-size: 13px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.roadmap-ver-name {
|
||||||
|
font-size: 11px;
|
||||||
|
letter-spacing: 0.1em;
|
||||||
|
text-transform: uppercase;
|
||||||
|
color: var(--text-dim);
|
||||||
|
margin-top: 0.15rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
.roadmap-content { padding: 1.5rem 1.5rem; }
|
||||||
|
|
||||||
|
.roadmap-status {
|
||||||
|
font-size: 11px;
|
||||||
|
letter-spacing: 0.1em;
|
||||||
|
text-transform: uppercase;
|
||||||
|
margin-bottom: 0.5rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
.roadmap-content h4 {
|
||||||
|
font-size: 13px;
|
||||||
|
font-weight: 700;
|
||||||
|
color: var(--text-bright);
|
||||||
|
margin-bottom: 0.5rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
.roadmap-content p { font-size: 12px; color: var(--text-dim); }
|
||||||
|
|
||||||
|
/* ── Footer ──────────────────────────────────────────────────────────── */
|
||||||
|
footer {
|
||||||
|
border-top: 1px solid var(--border);
|
||||||
|
background: var(--bg-panel);
|
||||||
|
padding: 2rem;
|
||||||
|
display: flex;
|
||||||
|
justify-content: space-between;
|
||||||
|
align-items: center;
|
||||||
|
flex-wrap: wrap;
|
||||||
|
gap: 1rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
.footer-copy {
|
||||||
|
font-size: 11px;
|
||||||
|
color: var(--text-dim);
|
||||||
|
letter-spacing: 0.05em;
|
||||||
|
}
|
||||||
|
|
||||||
|
.footer-links { display: flex; gap: 1.5rem; }
|
||||||
|
.footer-links a {
|
||||||
|
font-size: 11px;
|
||||||
|
color: var(--text-dim);
|
||||||
|
letter-spacing: 0.08em;
|
||||||
|
text-transform: uppercase;
|
||||||
|
transition: color 0.2s;
|
||||||
|
}
|
||||||
|
.footer-links a:hover { color: var(--blue); text-decoration: none; }
|
||||||
|
|
||||||
|
/* ── Divider ─────────────────────────────────────────────────────────── */
|
||||||
|
.divider {
|
||||||
|
border: none;
|
||||||
|
border-top: 1px solid var(--border);
|
||||||
|
margin: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ── Responsive ──────────────────────────────────────────────────────── */
|
||||||
|
@media (max-width: 640px) {
|
||||||
|
header { padding: 0 1rem; }
|
||||||
|
nav { display: none; }
|
||||||
|
.hero { padding: 4rem 1rem 3rem; }
|
||||||
|
.stats { flex-wrap: wrap; }
|
||||||
|
.stat { max-width: none; flex: 0 0 50%; border-right: none;
|
||||||
|
border-bottom: 1px solid var(--border); }
|
||||||
|
section { padding: 3rem 1rem; }
|
||||||
|
.roadmap-item { grid-template-columns: 1fr; }
|
||||||
|
.roadmap-version { border-right: none; border-bottom: 1px solid var(--border); }
|
||||||
|
footer { flex-direction: column; align-items: flex-start; }
|
||||||
|
}
|
||||||
|
</style>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
|
||||||
|
<!-- ── Header ──────────────────────────────────────────────────────────── -->
|
||||||
|
<header>
|
||||||
|
<div class="logo">TIMMY TIME <span>// MISSION CONTROL</span></div>
|
||||||
|
<nav>
|
||||||
|
<a href="#features">Features</a>
|
||||||
|
<a href="#architecture">Architecture</a>
|
||||||
|
<a href="#quickstart">Quickstart</a>
|
||||||
|
<a href="#agents">Agent Team</a>
|
||||||
|
<a href="#roadmap">Roadmap</a>
|
||||||
|
<a class="btn-primary" href="https://github.com/Alexspayne/Timmy-time-dashboard">GitHub →</a>
|
||||||
|
</nav>
|
||||||
|
</header>
|
||||||
|
|
||||||
|
<!-- ── Hero ────────────────────────────────────────────────────────────── -->
|
||||||
|
<section class="hero" style="max-width:100%; padding-left:2rem; padding-right:2rem;">
|
||||||
|
<p class="hero-label">Sovereign AI Agent System</p>
|
||||||
|
<h1>Your agents.<br><em>Your hardware.</em><br>Your sats.</h1>
|
||||||
|
<p class="hero-sub">
|
||||||
|
A local-first AI command center. Talk to Timmy, coordinate your swarm,
|
||||||
|
gate API access with Bitcoin Lightning — no cloud, no telemetry, no compromise.
|
||||||
|
</p>
|
||||||
|
<div class="hero-badges">
|
||||||
|
<span class="badge green">228 Tests Passing</span>
|
||||||
|
<span class="badge blue">FastAPI + HTMX</span>
|
||||||
|
<span class="badge amber">Lightning L402</span>
|
||||||
|
<span class="badge">No Cloud</span>
|
||||||
|
<span class="badge purple">Multi-Agent Swarm</span>
|
||||||
|
<span class="badge">MIT License</span>
|
||||||
|
</div>
|
||||||
|
<div class="hero-cta">
|
||||||
|
<a class="btn-primary" href="https://github.com/Alexspayne/Timmy-time-dashboard">View on GitHub</a>
|
||||||
|
<a class="btn-ghost" href="#quickstart">Get Started</a>
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
|
||||||
|
<!-- ── Stats ────────────────────────────────────────────────────────────── -->
|
||||||
|
<div class="stats">
|
||||||
|
<div class="stat">
|
||||||
|
<div class="stat-number">228</div>
|
||||||
|
<div class="stat-label">Tests Passing</div>
|
||||||
|
</div>
|
||||||
|
<div class="stat">
|
||||||
|
<div class="stat-number">20+</div>
|
||||||
|
<div class="stat-label">API Endpoints</div>
|
||||||
|
</div>
|
||||||
|
<div class="stat">
|
||||||
|
<div class="stat-number">11</div>
|
||||||
|
<div class="stat-label">Subsystems</div>
|
||||||
|
</div>
|
||||||
|
<div class="stat">
|
||||||
|
<div class="stat-number">0</div>
|
||||||
|
<div class="stat-label">Cloud Calls</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<hr class="divider" />
|
||||||
|
|
||||||
|
<!-- ── Features ─────────────────────────────────────────────────────────── -->
|
||||||
|
<section id="features">
|
||||||
|
<p class="section-label">Capabilities</p>
|
||||||
|
<h2>Everything in one dashboard</h2>
|
||||||
|
<p class="section-intro">
|
||||||
|
Built for the operator who wants sovereignty without sacrificing capability.
|
||||||
|
Every subsystem works offline.
|
||||||
|
</p>
|
||||||
|
<div class="feature-grid">
|
||||||
|
|
||||||
|
<div class="feature-card">
|
||||||
|
<span class="feature-icon">🤖</span>
|
||||||
|
<h3>Timmy Agent</h3>
|
||||||
|
<p>Agno-powered conversational agent backed by Ollama (llama3.2 default) or
|
||||||
|
AirLLM for 70B–405B models on Apple Silicon. SQLite memory, no cloud.</p>
|
||||||
|
<span class="feature-tag">Agno · Ollama · AirLLM</span>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="feature-card">
|
||||||
|
<span class="feature-icon">🌐</span>
|
||||||
|
<h3>Mission Control UI</h3>
|
||||||
|
<p>FastAPI backend with Jinja2 + HTMX frontend. Dark terminal aesthetic.
|
||||||
|
Real-time health polling, chat history, live swarm feed — no JavaScript framework.</p>
|
||||||
|
<span class="feature-tag">FastAPI · HTMX · Bootstrap 5</span>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="feature-card">
|
||||||
|
<span class="feature-icon">🐝</span>
|
||||||
|
<h3>Multi-Agent Swarm</h3>
|
||||||
|
<p>Spawn sub-agents, post tasks, run 15-second Lightning auctions. Registry,
|
||||||
|
manager, bidder, and coordinator — all in-process or as separate subprocesses.</p>
|
||||||
|
<span class="feature-tag">Coordinator · Registry · Auction</span>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="feature-card">
|
||||||
|
<span class="feature-icon">⚡</span>
|
||||||
|
<h3>L402 Lightning Payments</h3>
|
||||||
|
<p>Bitcoin Lightning payment gating via HMAC macaroons. Mock backend for dev,
|
||||||
|
LND gRPC-ready for production. Agents earn and spend sats autonomously.</p>
|
||||||
|
<span class="feature-tag">L402 · Macaroon · BOLT11</span>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="feature-card">
|
||||||
|
<span class="feature-icon">🎙️</span>
|
||||||
|
<h3>Voice I/O</h3>
|
||||||
|
<p>Pattern-matched NLU detects intents (status, swarm, task, help) from natural
|
||||||
|
language. TTS via pyttsx3 speaks responses aloud. Fully offline.</p>
|
||||||
|
<span class="feature-tag">NLU · pyttsx3 · Intent Detection</span>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="feature-card">
|
||||||
|
<span class="feature-icon">📱</span>
|
||||||
|
<h3>Mobile Optimized</h3>
|
||||||
|
<p>iOS safe-area, 44px touch targets, 16px inputs (no zoom), momentum scroll,
|
||||||
|
dynamic viewport height. 21-scenario HITL test harness built in.</p>
|
||||||
|
<span class="feature-tag">iOS · HITL · Responsive</span>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="feature-card">
|
||||||
|
<span class="feature-icon">🔴</span>
|
||||||
|
<h3>WebSocket Live Feed</h3>
|
||||||
|
<p>Real-time swarm events — agent joins, task posts, auction bids, completions —
|
||||||
|
broadcast over WebSocket to the live dashboard.</p>
|
||||||
|
<span class="feature-tag">WebSocket · Live Events</span>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="feature-card">
|
||||||
|
<span class="feature-icon">🛡️</span>
|
||||||
|
<h3>Security First</h3>
|
||||||
|
<p>XSS prevention via textContent (not innerHTML). Startup warnings for default
|
||||||
|
secrets. HMAC-signed macaroons. Graceful degradation on every optional service.</p>
|
||||||
|
<span class="feature-tag">XSS-safe · HMAC · Warnings</span>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="feature-card">
|
||||||
|
<span class="feature-icon">🔧</span>
|
||||||
|
<h3>Self-TDD Watchdog</h3>
|
||||||
|
<p>Continuous test runner polls pytest every 60 seconds and alerts on regressions.
|
||||||
|
Runs alongside dev work in the background — silent when green.</p>
|
||||||
|
<span class="feature-tag">pytest · self-tdd · CI</span>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
|
||||||
|
<hr class="divider" />
|
||||||
|
|
||||||
|
<!-- ── Architecture ──────────────────────────────────────────────────────── -->
|
||||||
|
<section id="architecture">
|
||||||
|
<p class="section-label">System Design</p>
|
||||||
|
<h2>Architecture</h2>
|
||||||
|
<p class="section-intro">
|
||||||
|
A layered local stack. Every dependency can degrade gracefully — Ollama offline?
|
||||||
|
Error message. Redis missing? In-memory pub/sub. pyttsx3 absent? TTS is a no-op.
|
||||||
|
</p>
|
||||||
|
<div class="arch-wrap">
|
||||||
|
<pre>
|
||||||
|
<span class="hl-blue">Browser / Phone</span>
|
||||||
|
│ HTTP + HTMX + WebSocket
|
||||||
|
▼
|
||||||
|
┌─────────────────────────────────────────────────────────┐
|
||||||
|
│ <span class="hl-blue">FastAPI (dashboard.app)</span> │
|
||||||
|
│ routes: agents · health · swarm · marketplace · voice │
|
||||||
|
└────────┬──────────────┬────────────────┬────────────────┘
|
||||||
|
│ │ │
|
||||||
|
▼ ▼ ▼
|
||||||
|
<span class="hl-green">Jinja2</span> <span class="hl-amber">Timmy Agent</span> <span class="hl-purple">Swarm Coordinator</span>
|
||||||
|
Templates │ ├─ Registry (SQLite)
|
||||||
|
(HTMX) ├─ <span class="hl-green">Ollama</span> ├─ AuctionManager (15s bids)
|
||||||
|
└─ <span class="hl-amber">AirLLM</span> ├─ SwarmComms (Redis / mem)
|
||||||
|
(70B–405B) └─ SwarmManager (subprocess)
|
||||||
|
│
|
||||||
|
├── <span class="hl-blue">Voice NLU + TTS</span> (pyttsx3, local)
|
||||||
|
├── <span class="hl-blue">WebSocket live feed</span> (ws_manager)
|
||||||
|
├── <span class="hl-amber">L402 Lightning proxy</span> (macaroon + BOLT11 invoice)
|
||||||
|
├── <span class="hl-green">Push notifications</span> (local + macOS native)
|
||||||
|
└── Siri Shortcuts API (iOS automation endpoints)
|
||||||
|
|
||||||
|
<span class="hl-dim">Persistence: timmy.db (Agno memory) · data/swarm.db (registry + tasks)
|
||||||
|
External: Ollama :11434 · optional Redis · optional LND gRPC</span>
|
||||||
|
</pre>
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
|
||||||
|
<hr class="divider" />
|
||||||
|
|
||||||
|
<!-- ── Quickstart ─────────────────────────────────────────────────────────── -->
|
||||||
|
<section id="quickstart">
|
||||||
|
<p class="section-label">Get Running</p>
|
||||||
|
<h2>Quickstart</h2>
|
||||||
|
<p class="section-intro">
|
||||||
|
Five minutes from zero to a running agent. You need Python 3.11+ and Ollama.
|
||||||
|
</p>
|
||||||
|
<div class="quickstart-steps">
|
||||||
|
|
||||||
|
<div class="step">
|
||||||
|
<div class="step-num">1</div>
|
||||||
|
<div>
|
||||||
|
<h4>Clone</h4>
|
||||||
|
<pre class="codeblock"><span class="cmd">git clone</span> https://github.com/Alexspayne/Timmy-time-dashboard.git
|
||||||
|
<span class="cmd">cd</span> Timmy-time-dashboard</pre>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="step">
|
||||||
|
<div class="step-num">2</div>
|
||||||
|
<div>
|
||||||
|
<h4>Install</h4>
|
||||||
|
<pre class="codeblock"><span class="cmd">make install</span>
|
||||||
|
<span class="cmt"># or manually:</span>
|
||||||
|
<span class="cmd">python3 -m venv</span> .venv <span class="cmt">&&</span> <span class="cmd">source</span> .venv/bin/activate
|
||||||
|
<span class="cmd">pip install</span> -e ".[dev]"</pre>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="step">
|
||||||
|
<div class="step-num">3</div>
|
||||||
|
<div>
|
||||||
|
<h4>Start Ollama</h4>
|
||||||
|
<pre class="codeblock"><span class="cmt"># In a separate terminal:</span>
|
||||||
|
<span class="cmd">ollama serve</span>
|
||||||
|
<span class="cmd">ollama pull</span> llama3.2 <span class="cmt"># ~2 GB, one-time download</span></pre>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="step">
|
||||||
|
<div class="step-num">4</div>
|
||||||
|
<div>
|
||||||
|
<h4>Launch</h4>
|
||||||
|
<pre class="codeblock"><span class="cmd">make dev</span>
|
||||||
|
<span class="cmt"># Opens at http://localhost:8000</span>
|
||||||
|
<span class="cmt"># Mobile: http://<your-lan-ip>:8000</span></pre>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="step">
|
||||||
|
<div class="step-num">5</div>
|
||||||
|
<div>
|
||||||
|
<h4>Test</h4>
|
||||||
|
<pre class="codeblock"><span class="cmd">make test</span> <span class="cmt"># 228 tests — no Ollama needed</span>
|
||||||
|
<span class="cmd">make test-cov</span> <span class="cmt"># + coverage report</span>
|
||||||
|
<span class="cmd">make watch</span> <span class="cmt"># self-TDD watchdog in background</span></pre>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
|
||||||
|
<hr class="divider" />
|
||||||
|
|
||||||
|
<!-- ── Agent Team ─────────────────────────────────────────────────────────── -->
|
||||||
|
<section id="agents">
|
||||||
|
<p class="section-label">Contributors</p>
|
||||||
|
<h2>The agent team</h2>
|
||||||
|
<p class="section-intro">
|
||||||
|
This repo is built by a multi-agent team. Each tool has a defined lane.
|
||||||
|
See <a href="https://github.com/Alexspayne/Timmy-time-dashboard/blob/main/AGENTS.md">AGENTS.md</a>
|
||||||
|
for the full development standards.
|
||||||
|
</p>
|
||||||
|
<div class="agent-grid">
|
||||||
|
|
||||||
|
<div class="agent-card">
|
||||||
|
<div class="agent-accent" style="background: var(--blue);"></div>
|
||||||
|
<div class="agent-name">Claude</div>
|
||||||
|
<div class="agent-role">Anthropic · Architect</div>
|
||||||
|
<ul class="agent-list">
|
||||||
|
<li>Foundation, scaffolding, CI</li>
|
||||||
|
<li>Testing and quality passes</li>
|
||||||
|
<li>Documentation and tooling</li>
|
||||||
|
<li>Iterative refinement</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="agent-card">
|
||||||
|
<div class="agent-accent" style="background: var(--purple);"></div>
|
||||||
|
<div class="agent-name">Kimi</div>
|
||||||
|
<div class="agent-role">Moonshot AI · Feature Engine</div>
|
||||||
|
<ul class="agent-list">
|
||||||
|
<li>High-volume feature drops</li>
|
||||||
|
<li>New subsystem builds</li>
|
||||||
|
<li>Large context, rapid expansion</li>
|
||||||
|
<li>Agent persona implementation</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="agent-card">
|
||||||
|
<div class="agent-accent" style="background: var(--amber);"></div>
|
||||||
|
<div class="agent-name">Manus</div>
|
||||||
|
<div class="agent-role">Manus AI · Security Specialist</div>
|
||||||
|
<ul class="agent-list">
|
||||||
|
<li>Security audits (XSS, injection)</li>
|
||||||
|
<li>Coverage gap analysis</li>
|
||||||
|
<li>Targeted bug fixes</li>
|
||||||
|
<li>Payment flow validation</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="agent-card">
|
||||||
|
<div class="agent-accent" style="background: var(--text-dim);"></div>
|
||||||
|
<div class="agent-name">Alex Payne</div>
|
||||||
|
<div class="agent-role">Human · Orchestrator</div>
|
||||||
|
<ul class="agent-list">
|
||||||
|
<li>Vision and product decisions</li>
|
||||||
|
<li>Agent task assignment</li>
|
||||||
|
<li>PR review and merge</li>
|
||||||
|
<li>Bitcoin / Lightning domain</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
|
||||||
|
<hr class="divider" />
|
||||||
|
|
||||||
|
<!-- ── Roadmap ────────────────────────────────────────────────────────────── -->
|
||||||
|
<section id="roadmap">
|
||||||
|
<p class="section-label">What's Next</p>
|
||||||
|
<h2>Roadmap</h2>
|
||||||
|
<p class="section-intro">Three phases, each named after a book.</p>
|
||||||
|
<div class="roadmap">
|
||||||
|
|
||||||
|
<div class="roadmap-item">
|
||||||
|
<div class="roadmap-version">
|
||||||
|
<div class="roadmap-ver-num">v1.0.0</div>
|
||||||
|
<div class="roadmap-ver-name">Genesis</div>
|
||||||
|
</div>
|
||||||
|
<div class="roadmap-content">
|
||||||
|
<div class="roadmap-status" style="color:var(--green);">✓ Complete</div>
|
||||||
|
<h4>Foundation</h4>
|
||||||
|
<p>Agno + Ollama + SQLite + FastAPI dashboard + HTMX + 228 tests.
|
||||||
|
CLI, mobile layout, Bootstrap, CI/CD, AirLLM big-brain backend.</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="roadmap-item">
|
||||||
|
<div class="roadmap-version">
|
||||||
|
<div class="roadmap-ver-num">v2.0.0</div>
|
||||||
|
<div class="roadmap-ver-name">Exodus</div>
|
||||||
|
</div>
|
||||||
|
<div class="roadmap-content">
|
||||||
|
<div class="roadmap-status" style="color:var(--amber);">⟳ In progress</div>
|
||||||
|
<h4>Multi-Agent Economy</h4>
|
||||||
|
<p>Swarm coordination, L402 Lightning payment gating, voice NLU/TTS,
|
||||||
|
marketplace, WebSocket live feed. Agent personas: Echo, Mace, Helm,
|
||||||
|
Seer, Forge, Quill. Real LND gRPC backend.</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="roadmap-item">
|
||||||
|
<div class="roadmap-version">
|
||||||
|
<div class="roadmap-ver-num">v3.0.0</div>
|
||||||
|
<div class="roadmap-ver-name">Revelation</div>
|
||||||
|
</div>
|
||||||
|
<div class="roadmap-content">
|
||||||
|
<div class="roadmap-status" style="color:var(--text-dim);">◌ Planned</div>
|
||||||
|
<h4>Sovereign Deployment</h4>
|
||||||
|
<p>Bitcoin Lightning treasury — agents earn and spend sats autonomously.
|
||||||
|
Single <code>.app</code> bundle for macOS (no Python install).
|
||||||
|
Federation between Timmy instances.</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
|
||||||
|
<hr class="divider" />
|
||||||
|
|
||||||
|
<!-- ── Footer ────────────────────────────────────────────────────────────── -->
|
||||||
|
<footer>
|
||||||
|
<div class="footer-copy">
|
||||||
|
TIMMY TIME // MISSION CONTROL · MIT License ·
|
||||||
|
No cloud. No telemetry. Sats are sovereignty.
|
||||||
|
</div>
|
||||||
|
<div class="footer-links">
|
||||||
|
<a href="https://github.com/Alexspayne/Timmy-time-dashboard">GitHub</a>
|
||||||
|
<a href="https://github.com/Alexspayne/Timmy-time-dashboard/blob/main/AGENTS.md">AGENTS.md</a>
|
||||||
|
<a href="https://github.com/Alexspayne/Timmy-time-dashboard/blob/main/README.md">README</a>
|
||||||
|
<a href="https://github.com/Alexspayne/Timmy-time-dashboard/issues">Issues</a>
|
||||||
|
</div>
|
||||||
|
</footer>
|
||||||
|
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
Reference in New Issue
Block a user