x-algorithm

This repository contains the core recommendation system powering the "For You" feed on X. It combines in-network content (from accounts you follow) with out-of-network content (discovered through ML-based retrieval) and

Fork. This README is generated by the agentic harness and is fork-local — exclude it from any upstream pull request. Upstream docs are preserved in README.original.md.

Table of Contents

• Overview
• Quick Start
• Agentic Architecture
• Model Routing
• Project Layout
• Development
• Related Repositories

Overview

This repository contains the core recommendation system powering the "For You" feed on X. It combines in-network content (from accounts you follow) with out-of-network content (discovered through ML-based retrieval) and

Stack	—
Frameworks	—
Tests	yes
Commits	2
Last activity	2026-08-10
Origin	fork of upstream

Quick Start

Install

# No dependency manifest detected — see source layout below.

Run

# Entry point not auto-detected; inspect the layout below.

Agentic Architecture

This fork participates in the sahiixx agentic harness — a shared contract for how agents plan, act, verify, and recover across the account.

Fork note: this file is fork-local. Drop it from any branch you open as a pull request upstream. The harness contract also lives in AGENTS.md.

Signal strength: agentic density score 41.

Patterns in play

Pattern	Role here
Prompt Chaining	Deterministic multi-step pipelines with known subtasks
Routing	Classify input, dispatch to the specialist path
Parallelization	Independent subtasks fan out; results aggregated
Orchestrator–Workers	Central planner decomposes dynamically
Evaluator–Optimizer	Generator/judge split with explicit rubric; bounded retry
ReAct	Interleaved reason → act → observe for adaptive tool use
Reflection	Self-critique before emitting a final answer

Reliability envelope

• Bounded execution — every loop has a max-iteration and wall-clock ceiling.
• Tool sandboxing — filesystem/network side effects isolated and reversible.
• Guardrail layering — validate at input, mid-loop, and output.
• Context engineering — select, compress, isolate; never grow unbounded.
• Self-verification — check intermediate output against constraints.

Model Routing

Agent work in this fork routes through Azure AI Foundry. See AGENTS.md.

Purpose	Deployment	Endpoint
Default / general	gpt-5.6-sol	/openai/v1/chat/completions
Deep reasoning	claude-opus-5	/openai/v1/responses only
Embeddings	text-embedding-3-small	/openai/v1/embeddings

export AZURE_FOUNDRY_API_KEY=...        # never commit this
export AZURE_FOUNDRY_BASE_URL=https://<resource>.openai.azure.com/openai/v1

Gotcha: Claude deployments on Azure return 404 api_not_supported on /chat/completions. They answer only via the Responses API.

Project Layout

AGENTS.md
CODE_OF_CONDUCT.md
LICENSE
README.md
candidate-pipeline/
home-mixer/
phoenix/
thunder/

Development

# no linter configured
gh workflow run hermes-azure-check.yml

Secrets live in environment variables and CI secrets — never in tracked files.

Related Repositories

Part of a 226-repository workspace sharing one agentic contract:

• agentic-harness — patterns, contracts, reference implementations
• AGENTS.md in every repo pins identical model routing

---

_{README maintained by the agentic harness · fork-local · regenerated 2026-08-10}