{"id":34901228,"url":"https://github.com/aahnik/pico-agent","last_synced_at":"2026-05-24T02:31:57.851Z","repository":{"id":320837565,"uuid":"1083498905","full_name":"aahnik/pico-agent","owner":"aahnik","description":"Barebones Agentic AI Framework in Python. Simple, Hackable, Extensible!","archived":false,"fork":false,"pushed_at":"2026-02-15T13:27:55.000Z","size":54,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-15T13:39:34.105Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aahnik.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-26T06:25:13.000Z","updated_at":"2026-02-15T07:58:56.000Z","dependencies_parsed_at":"2025-10-26T09:04:21.740Z","dependency_job_id":"11d57137-0f1c-42ac-99d1-650fd361274b","html_url":"https://github.com/aahnik/pico-agent","commit_stats":null,"previous_names":["aahnik/pico-agent"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/aahnik/pico-agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aahnik%2Fpico-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aahnik%2Fpico-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aahnik%2Fpico-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aahnik%2Fpico-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aahnik","download_url":"https://codeload.github.com/aahnik/pico-agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aahnik%2Fpico-agent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33419550,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T22:14:44.296Z","status":"online","status_checked_at":"2026-05-24T02:00:06.296Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-12-26T08:53:15.871Z","updated_at":"2026-05-24T02:31:57.846Z","avatar_url":"https://github.com/aahnik.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\u003cimg src=\"pico.svg\" alt=\"pico logo\" width=\"150\" height=\"150\"\u003e\n\n# pico-agent\n\n\n\n\u003e pico (p) = $`10^x , x = -12`$ (trillionth)\n\n_barebones alternative to langchain/langgraph, smolagents, pydantic ai etc_\n\nA very small and simple framework(defines the way of thinking/interacting) for building language model agents.\nThe primary purpose is to lay out a clean and quickly understandable abstraction for agents. You don't need to read large docs, or fight with the framework to customize it.\n\npico-agent provides the standard structure, and common features like traces(for observability/debugging), and interactions between models, tools, and agents. It gives you complete freedom to define and use any model, tool, or agentic flow/graph.\n\nThis is suited for when you will be probably working on some custom experiment, where you define your own agentic flows, and tools. Standard frameworks like langchain are built with the purpose to facilitate fast idea to production for any agentic flow. pico-agent is not production ready, it's meant for recreational purposes.\n\n\u003e pico-agent is a learning ramp, and hacker's paradise, ideal for play, and research.\n\n- You can implement your own model by inheriting the `Model` interface. To call any llm model you can call via their API, inference locally, by using any popular library. Use whatever you want, just wrap it up with the `Model` interface, and you can plug that model into the system.\n- You can implement any tool you wish, by inhering the `Tool`, where you define the pre and post prompt formatting of tool call, and tool response, and also the actual tool execution function\n- You can define a custom `ToolEngine` that manages tool calls. It decides what tool to call, how many tool calls to make, and every decision around tool calling. Particularly useful if you wish to define some custom metric or algorithm for tool call decisions instead of purely relying on LLM or standard flows defined in other frameworks.\n- You can chain up model calls sequences, or tool routing sequences, and package everything end to end in one single `Agent` that accomplishes one task\n- You can define multiple agents that can interact among themselves. [in roadmap]\n\n\nIf you need integrations with lots of popular tools, models and agentic workflows then something like langchain/langraph is more suitable. But if you are working on some custom project, where you need to hack lots of internal bits, to customize everything, welcome to pico-agent!\n\nContribute your ideas/feedback via creating issues. I plan to hand-write this small library to have absolute control and a solid mental map of everything. _Not accepting code from LLMs or other humans_.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faahnik%2Fpico-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faahnik%2Fpico-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faahnik%2Fpico-agent/lists"}