{"repo":"sergenes/mini_agent","free":true,"listed":false,"github":"https://github.com/sergenes/mini_agent","clone":"git clone https://github.com/sergenes/mini_agent.git","description":"A minimal AI agent built from scratch — no agent framework, just Python, the OpenAI SDK, and a `while` loop. Accompanies the Medium article \"Build Your Own AI Agent from Scratch.\" Three execution modes: `local` (Ollama only), `remote` (cloud provider), `mixed` (local orchestrates, delegates to remote).","language":"Python","stars":28,"topics":["aitools","iagents","llm","mcp","mcp-client","mcp-server","ollama","open-source","python","react"],"license":null,"category":"mcp-servers","readme_excerpt":"Mini Agent A minimal AI agent built without any agent framework — just Python, the OpenAI SDK, and a while loop. This project accompanies the Medium article series by Sergey Neskoromny: Software Engineering in the Agentic Era\" series - Part 1: Building an AI Agent from Scratch: No Magic, Just a Deterministic Loop - Part 2: Your AI Agent Will Fail. Here's How to Make It Recoverable. - Part 3: Building Complete Systems from Day One: Why Simple-First Has Become Expensive in the AI Era - Part 4: Give Your Testing Agent Eyes: A Visual Testing Agent from Scratch - Part 5: The Agent Built the Feature in Four Minutes. Deploying It Took Me Forty. — deployment-pipeline/ Follow me on LinkedIn and Medium for more on AI tools, mobile development, and whatever I'm currently building! --- What it does The agent takes a task, calls tools when needed, observes the results, and loops until it has a final answer. Three modes: Mode What happens ------ -------------- local All LLM calls go to a local Ollama model — fully offline remote All LLM calls go to a cloud provider (OpenAI, Anthropic, or Gemini) mixed Local Ollama orchestrates the loop; it delegates complex subtasks to the remote model via ask remote() Setup For local/mixed mode, install Ollama and pull a model that supports function calling: --- Usage Local (Ollama only) Remote (cloud provider) Mixed (local orchestrates, remote handles complex reasoning) In mixed mode the local model decides what to handle itself and when to call ask remo","default_branch":null,"files":null,"tree":[],"storefront":"/r/sergenes","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/sergenes/mini_agent/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}