Project Info
When journalism censors, panders, and distorts, it’s not news. It’s control. They call it journalism. We call it a leash. A carefully constructed reality designed to keep you complacent, anxious, and clicking. Fourth Branch is the antidote. Our AI agents surface the stories that matter to you and the ones you're not supposed to see — sourced, labeled, and engineered to break your bubble wide open. This isn’t about showing you “the other side.” It’s about showing you the whole battlefield. Our Assembly Line of Truth Our platform uses a three-agent system to ensure quality and depth. Here’s the breakdown: Agent 1: The Lookout (Topic Generator): It all starts here. This agent scans news feeds and the web to identify crucial stories based on user interests and their personal information. It decides what topics demand a deeper look and generates one detailed line as the output. Agent 1: The Lookout (Topic Generator): It all starts here. This agent scans news feeds and the web to identify crucial stories based on user interests and their personal information. It decides what topics demand a deeper look and generates one detailed line as the output. Agent 2: The Investigator (Report Generator): Based on your chosen topic, our LangGraph engine runs a comprehensive web search, accumulating and analyzing results to build a research-backed dossier — with up to 15 raw and cited sources that represent diverse perspectives. Agent 2: The Investigator (Report Generator): Based on your chosen topic, our LangGraph engine runs a comprehensive web search, accumulating and analyzing results to build a research-backed dossier — with up to 15 raw and cited sources that represent diverse perspectives. Agent 3: The Wordsmith (Final Writer): The Investigator's factual dossier is handed to our final agent, which transforms the raw report into a sharp, coherent article formatted in the user's preferred writing style. It’s not just information; it's intelligence tailored for you. Agent 3: The Wordsmith (Final Writer): The Investigator's factual dossier is handed to our final agent, which transforms the raw report into a sharp, coherent article formatted in the user's preferred writing style. It’s not just information; it's intelligence tailored for you. 24 Hours of Chaos: Challenges & Fixes Agent Coordination: Getting three autonomous AIs to work in perfect sequence without going rogue was our biggest debugging challenge. AI Safety & Guardrails: We implemented strict protocols to keep the AI's output factual and prevent it from generating harmful content. No friendly fire. Deployment Under Fire: Shipping a full-stack, multi-agent app with a database and frontend in 24 hours is a trial by fire. We survived. Highlights We’re Hyped About Radical Transparency: We built live frontend streaming so you can watch our agents work. No black boxes. We show our work—always. An Intuitive Cockpit: We delivered a clean UX that makes navigating complex, debiased information feel intuitive, not overwhelming. The Truth, On Demand: We shipped with multimodal output. You can read the article or listen to the generated podcast. The truth is now portable. The Rebellion is Just Beginning. What we built in 24 hours is just the first shot. Here's where we're aiming next: Go Global: Expand our agents to research and report in multiple languages, breaking the anglo-centric news bubble. Trace the Process: Watch the agent work in real time — from query to conclusion — with interactive visualizations showing each step, source, and connection behind the story. Expose the Echo Chamber: Offer users a tool to analyze their own media habits and see the shape of the bubble others have built around them. This is Day One. Welcome to the rebellion.
The Fourth Branch
AI-powered personalized news with radical transparency.
🔍 Overview
Fourth Branch is an AI news platform that builds personalized, bias-labeled stories by sourcing, verifying, and visualizing information from across the web. It combines a frontend app, a LangGraph-based agent system, and a structured database.
⚙️ Tech Stack
- Frontend: Next.js, Typescript, Tailwind CSS
- Backend: FastAPI, Python
- Database: Supabase(PostgreSQL)
- LLMs: LangGraph, Claude4, OpenAI, Gemini
🧠 Key Folders
frontend/: Next.js-based UI with user interest input, main page and article view.
backend/agent/: Handles the entire news generation process using three AI agents.
db/: SQL scripts and schema for PostgreSQL.
💡 News Generation Workflow
UC Berkeley AI Hackathon 2025
Analysis
View
Metric
- 53
- 16
- 13
Figures cover GitHub contributors during the hackathon window. A co-authored commit counts in full for each author, so per-member totals add up to more than the whole-team figures.
Technology
- CSSIn code
- FastAPIIn code
- JavaScriptIn code
- LangChainIn code
- Next.jsIn code
- OpenAIIn code
- PythonIn code
- ReactIn code
- SQLIn code
- SupabaseIn code
- Tailwind CSSIn code
- TypeScriptIn code
- Google GeminiClaimed
- VercelClaimed
12 of 14 appear in the indexed code. 2 claimed on Devpost could not be matched to code, which may simply mean the tool leaves no trace in the repository.
AI coding agents
No AI coding agent signals were found in this repository.
Detected from committed agent config files and commit authorship. Absence of a signal is not proof an agent was unused.
Codebase size
Source size
256 KB
Source files
57
Counts recognized source files only; vendored directories, binaries and lockfiles are excluded, so this is smaller than the repository on disk.
Repository
fourthbranch/tfb-calhacks
78 files · 1.2 MB · @ 86ddc48
Structure
Interface
33 files · 42%Screens, components and styles rendered to the user.
Application logic
17 files · 22%Domain rules, services and shared utilities.
Data & schema
1 file · 1%Schema definitions, migrations and data access.
Supporting
Layers are inferred from where files sit in the tree, not from reading the code. A project that names its directories unconventionally will read oddly here — open the file browser to check anything the diagram implies.
Languages
- Python56%
- TypeScript39%
- Markdown3%
- CSS1%
- SQL0%
- JavaScript0%
Share of indexed source by file size. Binary and vendored files are excluded.
Dependencies
frontend/package.json
npm · 22- @radix-ui/react-checkbox
- @radix-ui/react-label
- @radix-ui/react-radio-group
- @radix-ui/react-separator
- class-variance-authority
- clsx
- framer-motion
- lucide-react
- next
- react
- react-dom
- tailwind-merge
- +10 more
requirements.txt
pypi · 20- aiohttp
- beautifulsoup4
- exa_py
- fastapi
- google-generativeai
- httpx
- langchain
- langchain_anthropic
- langchain_community
- langchain_core
- langgraph
- linkup
- linkup_sdk
- markdownify
- openai
- pydantic
- python-dotenv
- supabase
- +2 more
Declared in the repository’s manifests at the indexed commit. A declared package is not proof it is used, and runtime dependencies are listed first.
This project’s features have not been analysed yet.
Export this project's context (description, README, evidence, key source files) to chat with an AI agent elsewhere.