58+ Tools Ready to Use
From finance, data science, DevOps, and academic research to news, social, translation, QR codes, OCR, audio transcription, image analysis, document parsing (PDF/DOCX/Excel), geo/weather, and email/webhook communication — everything your agent needs, built in. 14 new tools landed in v0.2.6.
Calculator
Perform mathematical calculations, evaluate expressions, and convert units
CodeExecutor
Execute code in a secure sandboxed environment (Python, JS, Bash)
PythonREPL
Execute Python code in a persistent REPL session
WebSearch
Search the web using DuckDuckGo, SerpAPI, or Google
URLFetchTool
Fetch webpage content and extract readable text
JSONTool
Parse, query (JSONPath), validate, and format JSON data
FileOperations
Safe file system operations: read, write, search, convert
BashTool
Execute shell commands with security controls
One-Line Agent Creation with 8 Presets
Ready-to-use configurations optimized for common use cases. v0.2.6 adds media and notify.
math
Mathematical computations
create_agent("math", model)research
Web · academic · news · social · video · docs
create_agent("research", model)coding
Code execution & development
create_agent("coding", model)general
All 32 general-purpose tools
create_agent("general", model)rag
Retrieval-augmented Q&A over your docs
create_agent("rag", model,
knowledge_base="./docs/")media
Audio transcription + vision captioning
create_agent("media", model)notify
Email + Slack + Discord notifications
create_agent("notify", model)minimal
Direct inference, no tools
create_agent("minimal", model)Up and Running in 60 Seconds
Three practical steps to your first local or cloud-backed AI agent. Expand the advanced section for budget-aware routing, thinking/grounding/caching, and persistent cost tracking.
Install
One command for the core; add an extra only when you need that provider.
pip install -U effgen
# Optional extras
pip install "effgen[vllm]" # local CUDA throughput
pip install "effgen[cerebras]" # Cerebras
pip install "effgen[groq]" # GroqSet Keys & Check
Export the keys you have, then run the doctor to confirm what's wired up.
export OPENAI_API_KEY="..."
export GROQ_API_KEY="..."
export CEREBRAS_API_KEY="..."
effgen doctor # table of providers + key status
effgen doctor --json # machine-readableCreate an Agent
Same Agent API across local SLMs and any registered cloud provider.
from effgen import load_model
from effgen.presets import create_agent
# Cloud
model = load_model("gpt-5.4-nano", provider="openai")
# model = load_model("groq:llama-3.3-70b-versatile")
# Or local
# model = load_model("Qwen/Qwen2.5-3B-Instruct", quantization="4bit")
agent = create_agent("general", model)
print(agent.run("What is (17 * 23) + sqrt(144)?").output) # 403See effGen in Action
Real-world examples showcasing the power and versatility
Code Assistant
Generate, execute, and debug code with sandboxed CodeExecutor and PythonREPL. Real-time streaming.
Research Agent
Comprehensive research using WebSearch, Wikipedia, and URLFetch. Detailed reports with citations.
Data Analysis Pipeline
Load, clean, and analyze data with PythonREPL and FileOps. Create visualizations and insights.
Multi-Agent System
Coordinate specialized agents for complex workflows. A2A protocol with streaming callbacks.
Weather & JSON Pipeline
Fetch real-time weather data, process JSON responses, and format reports using WeatherTool and JSONTool.
RAG Knowledge Base
Build a knowledge base with document loaders, chunking strategies, and hybrid search (vector + BM25).
Join Our Growing Developer Community
Connect with developers building the future of AI agents
GitHub
Star the repo, contribute code, report issues, and stay updated with the latest releases.
Connect with us professionally, follow company updates, and network with the team.
Twitter/X
Follow us for the latest updates, announcements, tips, and community highlights.
Discord
Join our active community, get help, share projects, and discuss the future of AI agents.
Want to learn more about our community?
Visit our dedicated community page for resources, events, and contribution guidelines.
Explore Community