Show HN: Freeact – A Lightweight Library for Code-Action Based Agents
https://github.com/gradion-ai/freeact
Hello! We just released freeact (https://github.com/gradion-ai/freeact), a lightweight agent library that empowers language models to act as autonomous agents through executable code actions.By enabling agents to express their actions directly in code rather than through constrained formats like JSON, freeact provides a flexible and powerful approach to solving complex, open-ended problems that require dynamic solution paths.
* Supports dynamic installation and utilization of Python packages at runtime
* Agents learn from feedback and store successful code actions as reusable skills in long-term memory
* Skills can be interactively developed and refined in collaboration with freeact agents
* Agents compose skills and any other Python modules to build increasingly sophisticated capabilities
* Code actions are executed in ipybox (https://github.com/gradion-ai/ipybox), a secure Docker + IPython sandbox that runs locally or remotely
GitHub repo: https://github.com/gradion-ai/freeact
Evaluation: https://gradion-ai.github.io/freeact/evaluation/
See it in action: https://github.com/user-attachments/assets/83cec179-54dc-456...
We'd love to hear your feedback!
Can you give examples of crucial obscure implementations compared to your approach?
While other libraries or frameworks may offer convenience through extensive abstractions, this often creates black boxes that complicate debugging and customization when you go beyond standard use cases. For example, when you need to trace what prompts are being sent to the LLM or how tool outputs are being processed, multiple layers of abstraction can make this difficult to inspect. With our approach you can easily trace the flow from agent decision to code execution.
HTH!