Skip to content

Commit f445466

Browse files
committed
docs: convert drafts into website posts
1 parent 7faf1a8 commit f445466

7 files changed

Lines changed: 98 additions & 0 deletions

File tree

File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
+++
2+
title="Building a GitHub Actions-Style Runner with Firecracker VMs and Knowledge Graph Learning"
3+
date=2025-12-25
4+
5+
[taxonomies]
6+
categories = ["Engineering", "Rust", "CI"]
7+
tags = ["Terraphim", "firecracker", "github-actions", "microvm", "knowledge-graph"]
8+
[extra]
9+
toc = true
10+
comments = true
11+
+++
12+
13+
We built a production-ready GitHub Actions-style workflow runner that combines Firecracker microVM isolation with knowledge-graph-driven learning about what actually works.
14+
15+
<!-- more -->
16+
17+
## Overview
18+
19+
The `terraphim_github_runner` crate provides a complete system for:
20+
21+
1. Processing GitHub webhook events into executable workflows
22+
2. Spawning and managing Firecracker microVMs for isolated command execution
23+
3. Tracking command execution patterns in a knowledge graph
24+
4. Learning from success/failure to improve future workflows
25+
26+
## Architecture
27+
28+
### High-Level Data Flow
29+
30+
```text
31+
GitHub Webhook -> WorkflowContext -> ParsedWorkflow -> SessionManager
32+
|
33+
Create VM
34+
|
35+
Execute Commands (VmCommandExecutor)
36+
|
37+
+-----------------+-----------------+
38+
| |
39+
LearningCoordinator CommandKnowledgeGraph
40+
(success/failure stats) (pattern learning)
41+
```
42+
43+
## Key Components
44+
45+
### 1. VM Executor
46+
47+
The VM executor is the bridge to Firecracker.
48+
49+
### 2. Command Knowledge Graph
50+
51+
The knowledge graph tracks command execution patterns.
52+
53+
## Source Material
54+
55+
- Source: `docs/archive/blog-posts/github-runner-architecture.md`
Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
+++
2+
title="Building Privacy-First AI Tools with X Integration"
3+
date=2026-01-19
4+
5+
[taxonomies]
6+
categories = ["Engineering", "AI", "Product"]
7+
tags = ["Terraphim", "privacy", "local-first", "knowledge-graph", "x"]
8+
[extra]
9+
toc = true
10+
comments = true
11+
+++
12+
13+
Knowledge work is fragmented across tools. We are building Terraphim to unify search across that mess without forcing you to upload your private data to cloud AI services.
14+
15+
<!-- more -->
16+
17+
## The Knowledge Fragmentation Problem
18+
19+
You remember reading a specific solution. You know it exists. But it is scattered across:
20+
21+
- local notes
22+
- team docs
23+
- code repositories
24+
- public Q&A
25+
- social technical threads
26+
27+
A local-first assistant is only useful if it can connect those sources in one place.
28+
29+
## The Privacy Dilemma
30+
31+
Most assistants solve search by centralizing your data on external servers.
32+
33+
Terraphim is designed to run locally. Your data stays on your machine.
34+
35+
## Why X Integration
36+
37+
Technical discussions happen in threads long before they become "official docs".
38+
39+
We want to index the specific X threads you care about into your local knowledge graph so they become searchable alongside your private notes.
40+
41+
## Source Material
42+
43+
- Source: `docs/archive/marketing/blog-post.md`

0 commit comments

Comments
 (0)