clean up readme

Author: TechFusionData

README.md

@@ -1,70 +1,25 @@
-# DevScout 🔍
+# DevScout
 
-**Ethereum open-source intelligence agent** — built with [ElizaOS v2](https://elizaos.ai) and powered by [Nosana](https://nosana.io) decentralised GPU compute.
+Ethereum OSINT agent that helps developers find contribution-ready issues across major protocol clients. Built with ElizaOS v2, runs on Nosana's decentralised GPU network.
 
-DevScout helps developers find high-quality contribution opportunities across major Ethereum protocol clients, reports live chain health, and explains GitHub issues with difficulty estimates.
+## What it does
 
----
+**Find issues to work on** — scans 5 Ethereum repos (Lodestar, Lighthouse, Alloy, Reth, go-ethereum) for `good first issue` and `help wanted` labels. Filter by language if you only write Rust, TypeScript, or Go.
 
-## What DevScout Can Do
+**Check chain health** — pulls live gas price, beacon epoch, and participation rate from public RPCs and beaconcha.in.
 
-### 1. Scan for Contribution-Ready Issues
-DevScout searches 5 major Ethereum repositories for `good first issue` and `help wanted` tickets:
+**Explain issues** — paste a GitHub issue URL and get a plain-language summary with a difficulty estimate and suggested approach.
 
-| Repository | Language | Client Type |
+## Repos it watches
+
+| Repository | Language | Type |
 |---|---|---|
 | [ChainSafe/lodestar](https://github.com/ChainSafe/lodestar) | TypeScript | Consensus |
 | [sigp/lighthouse](https://github.com/sigp/lighthouse) | Rust | Consensus |
 | [alloy-rs/alloy](https://github.com/alloy-rs/alloy) | Rust | Libraries |
 | [paradigmxyz/reth](https://github.com/paradigmxyz/reth) | Rust | Execution |
 | [ethereum/go-ethereum](https://github.com/ethereum/go-ethereum) | Go | Execution |
 
-Filter by language: *"Show me Rust issues"* or *"Find TypeScript good first issues"*
-
-### 2. Live Ethereum Network Status
-```
-Gas Price: 12.34 Gwei
-Beacon Epoch: 321,456
-Participation Rate: 99.2%
-```
-Sourced from `ethereum.publicnode.com` and `beaconcha.in`.
-
-### 3. Issue Summariser
-Paste any GitHub issue URL and DevScout will:
-- Summarise the problem in plain language
-- Estimate difficulty (beginner / intermediate / advanced)
-- Suggest how to approach the fix
-
----
-
-## Quick Start
-
-### Prerequisites
-- [Bun](https://bun.sh) runtime
-- [ElizaOS CLI](https://elizaos.ai/docs/cli): `npm install -g @elizaos/cli`
-- A [Nosana](https://nosana.io) API key (for Qwen3.5 inference)
-- GitHub Personal Access Token (optional, for higher rate limits)
-
-### Setup
-
-```bash
-git clone https://github.com/TechFusionData/eth-devscout.git
-cd eth-devscout
-bun install
-cp .env.example .env
-# Edit .env with your Nosana API key and GitHub token
-```
-
-### Run
-
-```bash
-bun run start
-# or for development with hot reload:
-bun run dev
-```
-
----
-
 ## Architecture
 
 ```
@@ -80,34 +35,29 @@ ElizaOS Runtime
     └─► SUMMARIZE_ISSUE        (GitHub Issues API → plain-language summary)
 ```
 
-All inference runs on **Nosana's decentralised GPU network** using `Qwen3.5-27B-AWQ-4bit`.
-
----
+Inference runs on Nosana GPUs using Qwen3.5-27B-AWQ-4bit.
 
-## Tech Stack
+## Setup
 
-- **ElizaOS v2** — agent framework
-- **Nosana** — decentralised GPU inference (Qwen3.5-27B-AWQ-4bit)
-- **GitHub REST API v3** — issue discovery
-- **ethereum.publicnode.com** — free Ethereum RPC
-- **beaconcha.in** — beacon chain explorer API
-- **TypeScript** — type-safe plugin code
-- **Bun** — fast JS runtime
+Needs [Bun](https://bun.sh) and [ElizaOS CLI](https://elizaos.ai/docs/cli) (`npm install -g @elizaos/cli`).
 
----
+```bash
+git clone https://github.com/TechFusionData/eth-devscout.git
+cd eth-devscout
+bun install
+cp .env.example .env
+# Add your Nosana API key and (optionally) GitHub token for higher rate limits
+bun run start
+```
 
-## Nosana Builders Challenge
+## Stack
 
-This agent is submitted to the [Nosana Builders Challenge](https://earn.superteam.fun/listing/nosana-builders-challenge) — *Build an ElizaOS v2 AI agent that runs on Nosana's GPU network.*
+ElizaOS v2 · Nosana GPU (Qwen3.5-27B) · GitHub REST API v3 · ethereum.publicnode.com · beaconcha.in · TypeScript · Bun
 
-The challenge rewards agents that demonstrate:
-- ✅ Real utility (contribution discovery for Ethereum developers)
-- ✅ Live data integration (chain status, GitHub API)
-- ✅ ElizaOS v2 plugin architecture
-- ✅ Deployment on Nosana GPU infrastructure
+## Context
 
----
+Built for the [Nosana Builders Challenge](https://earn.superteam.fun/listing/nosana-builders-challenge) — the prompt was to build an ElizaOS v2 agent running on Nosana infrastructure. I wanted something with actual utility for Ethereum contributors rather than another chatbot wrapper, so this focuses on reducing the friction of finding a good first PR across the ecosystem.
 
 ## License
 
-MIT © TechFusionData
+MIT