A transparent, minimal, and hackable agent framework. ~300 lines of readable code. Full control, no magic.
# Add to your Claude Code skills
git clone https://github.com/howl-anderson/agentsilexA transparent, minimal, and hackable agent framework for developers who want full control.
Read the entire codebase in one sitting. Understand exactly how your agents work. No magic, no hidden complexity.
While large agent frameworks offer extensive features, they often become black boxes that are hard to understand, customize, or debug. AgentSilex takes a different approach:
No comments yet. Be the first to share your thoughts!

Real-time streaming response demonstration - see how AgentSilex processes queries and streams results
pip install agentsilex
Or with uv:
uv add agentsilex
from agentsilex import Agent, Runner, Session, tool
# Define a simple tool
@tool
def get_weather(city: str) -> str:
"""Get weather information for a city."""
# In production, this would call a real weather API
return "SUNNY"
# Create an agent with the weather tool
agent = Agent(
name="Weather Assistant",
model="gemini/gemini-2.0-flash", # Switch models: openai/gpt-4, anthropic/claude-3-5-sonnet, deepseek/deepseek-chat, et al.
instructions="Help users find weather information using the available tools.",
tools=[get_weather]
)
# Create a session to track conversation history
session = Session()
# Run the agent with a user query
runner = Runner(session)
result = runner.run(agent, "What's the weather in Monte Cristo?")
print(result.final_output)
# Output: "The weather in Monte Cristo is SUNNY."
That's it! In just 20 lines, you have a working agent that: