IsuruMaduranga/harness-engineering-101
Can I trust it?
Be careful with this one.
Stars from real accounts No data
We haven't checked its stars for fakes yet.
Active OK
Last change today.
Licence Careful
No licence: legally you can't reuse the code, unless the README says otherwise.
Quick checks from public data. They help, but they are no guarantee.
What it is
A book-length series in Markdown that explains how AI agents work by building a roughly 300-line toy agent harness in plain Python. It covers the LLM message array, tool calls, the agent loop, context management, subagents, and related patterns across 16 chapters.
Who it's for
Python developers who want to understand how AI agents and LLM tool-use loops are built from first principles
How to use it
Ask your AI to set it up
Paste this into Claude, ChatGPT or your coding assistant.
Help me install and set up IsuruMaduranga/harness-engineering-101 in my project. Follow its README: https://github.com/IsuruMaduranga/harness-engineering-101. Explain each step and check it is safe before running anything.
Star curve
On the radar
Its place among the radar's top 100, day by day, with #1 at the top. Gaps are days it was out of the top 100.
Records
- Best place on RepoAlerts: #34, on 20 Oct 2026
- On the Hacker News front page on 19 Oct 2026
On Hacker News
- Harness Engineering 101: The LLM is the brain, the harness is the body132 points · 64 comments · 19 Oct 2026
Get alerts for repos like this
We'll email you when something in AI agents starts rising. Free, once a week, only what matches.
18,267 GitHub repos watched and ranked every hour. Figures as of 20 October 2026.
What arrives: one email on Mondays with the repos that match, never more. See last week's. Privacy
For maintainers
Add this badge to your README. It shows the repo's place on the radar, updates every hour and links back to this page.
[](https://repoalerts.com/repo/IsuruMaduranga/harness-engineering-101?ref=badge)Similar repos
- google-research/harness2
A Python framework for recursive harnessing of AI agents, which optimizes the prompts, tools, memory, skills and orchestration around a fixed model. It refines the harness per task through propose, pr
- zgcagi/Harness-RSI
A survey and curated reading list on harness self-evolution, where an LLM agent's persistent harness state (prompts, memory, skills, tools, and control logic) is updated from execution experience whil
- AntoGA/agents-contract
A template AGENTS.md contract for AI coding agents, a zero-dependency Python linter that checks it for required sections, placeholders, secrets and size, and a SessionStart hook that runs the linter a
- AgnesAI-Labs/agnes-harness
A pluggable TypeScript agent harness for Forward Deployed Engineering. It connects models, tools, task state and business interfaces through plugins, runs and records agent work with approvals and a c
- 15838328874/pi
A self-hostable, multi-tenant AI agent platform in Python, reimplementing the pi coding agent harness as an HTTP service. Includes streaming LLM adapters, an asyncio agent loop, sandboxed tool executi
- aicodeking/leanrea
A single 8 KB agent skill file that tells an AI agent which command-line tools to use for reverse engineering each kind of target (Electron/asar, Mach-O, Go and other binaries, bundles, APKs, firmware