A toolset for agentic workflows
Project description
agentic-tools
A python package that lets you setup agents with tools very easy
All you need is to add a docorator do the function that should be made accessable to the LLM.
from agentic_tools import ai_tool
def llm_can_not_use():
pass
@ai_tool
def llm_can_use():
pass
Be awere that this will eat more input tokens, since you are adding context of the functions.
Context that gets added
- Function signarure, icludeing, arguments and type hints
- Docstring
install
pip install agentic-tools
Agentic tools needs a LangChain object chat model.
build
git clone git@github.com:AxelGard/agentic-tools.git
cd agentic-tools
python3 -m venv env
source ./env/bin/activate
pip install -e .
# or
# pip install -e .[dev]
# if you want dev depenacies
DEMO
you can check out my expriment notebook
or
suppose you have some functions that you want you LLM to be able to call.
Agentic tools allows you to just add a decorator to it and then the agent will have access to those tools.
All LangChain models are supported, but for this demo I will use Ollama with llama3.1
install
install Ollma
curl -fsSL https://ollama.com/install.sh | sh
and then run ollama
ollama run llama3.1
install the python dependacnices
pip install agentic-tools langchain-ollama yfinance
Example
from langchain_ollama.chat_models import ChatOllama
from agentic_tools import ai_tool, Agent
import yfinance as yf
@ai_tool
def get_stock_price(symbol: str, period:str="1d") -> str:
stock = yf.Ticker(symbol)
price = stock.history(period=period)["Close"].iloc[0]
return f"The stock price of {symbol} was ${price:.2f} {period} ago"
@ai_tool
def get_market_cap(symbol: str) -> str:
stock = yf.Ticker(symbol)
cap = stock.info.get("marketCap", None)
if cap:
return f"The market cap of {symbol} is ${cap:,}"
return f"Market cap data for {symbol} is not available."
@ai_tool
def get_pe_ratio(symbol: str) -> str:
""" Will return P/E ratrio of the company """
stock = yf.Ticker(symbol)
pe = stock.info.get("trailingPE", None)
if pe:
return f"The P/E ratio of {symbol} is {pe:.2f}"
return f"P/E ratio data for {symbol} is not available."
llm = ChatOllama(model="llama3.1", temperature=0)
agent = Agent(llm_chat_model=llm)
query = "what was apples stock price a 5 days ago?"
print(f"{agent.query(question=query)}\n")
# The stock price of AAPL was $210.16 5d ago
query="who are you?"
print(f"{agent.query(question=query)}\n")
# I'm an AI assistant. I don't have a personal identity or emotions, but I can provide information and help with tasks to the best of my abilities. How can I assist you today?
from langchain_ollama.chat_models import ChatOllama
from agentic_tools import ai_tool, Agent
llm = ChatOllama(model="llama3.1", temperature=0)
agent = Agent(llm_chat_model=llm)
@ai_tool
def execute_python_code(python_code_as_string:str) -> str:
"""
This tool that lets you execute python code and returns the result as a string.
So if you want the result of a expression remeber to print it.
If you need more then one line of code then you need to seperate with `;`
So if you want to use this tool just call it with the python code and NOTHING ELSE.
When you get a result that you are satesfied with then you should respond with that result"""
print(python_code_as_string)
try:
return str(exec(python_code_as_string))
except Exception as e:
return str(e)
query="write the needed code that you need to calculate 2 to the power of 88"
r = "None"
while True:
r = agent.query(question=f"Question:{query}; result:{r}")
print(r)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agentic_tools-0.2.0.tar.gz.
File metadata
- Download URL: agentic_tools-0.2.0.tar.gz
- Upload date:
- Size: 5.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c4747dc3894808a5e83b6f50ca1d29cec26095cdb7e6b3cc04d114236f123ea9
|
|
| MD5 |
afc58b2a7ebb731387957c2458e1d488
|
|
| BLAKE2b-256 |
09bb4aa1e252e18a6c5561f465fc010c84ac44439fafde02192808c040d35520
|
Provenance
The following attestation bundles were made for agentic_tools-0.2.0.tar.gz:
Publisher:
release.yaml on AxelGard/agentic-tools
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
agentic_tools-0.2.0.tar.gz -
Subject digest:
c4747dc3894808a5e83b6f50ca1d29cec26095cdb7e6b3cc04d114236f123ea9 - Sigstore transparency entry: 308724336
- Sigstore integration time:
-
Permalink:
AxelGard/agentic-tools@806d425c4556d5bce8ec7a5222ed050c57f4c4f8 -
Branch / Tag:
refs/heads/master - Owner: https://github.com/AxelGard
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yaml@806d425c4556d5bce8ec7a5222ed050c57f4c4f8 -
Trigger Event:
push
-
Statement type:
File details
Details for the file agentic_tools-0.2.0-py3-none-any.whl.
File metadata
- Download URL: agentic_tools-0.2.0-py3-none-any.whl
- Upload date:
- Size: 5.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
29f9e94ddf86a30b3b3f016d5a545c1fcee409ece6a8d4e69ed143748b9337d0
|
|
| MD5 |
18973f7de880d2a3e245bb4d001ed30f
|
|
| BLAKE2b-256 |
d3e7b978827e729151f0be6ff45345f01d7dfc58dbd29065a09a3b91e42e70ef
|
Provenance
The following attestation bundles were made for agentic_tools-0.2.0-py3-none-any.whl:
Publisher:
release.yaml on AxelGard/agentic-tools
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
agentic_tools-0.2.0-py3-none-any.whl -
Subject digest:
29f9e94ddf86a30b3b3f016d5a545c1fcee409ece6a8d4e69ed143748b9337d0 - Sigstore transparency entry: 308724362
- Sigstore integration time:
-
Permalink:
AxelGard/agentic-tools@806d425c4556d5bce8ec7a5222ed050c57f4c4f8 -
Branch / Tag:
refs/heads/master - Owner: https://github.com/AxelGard
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yaml@806d425c4556d5bce8ec7a5222ed050c57f4c4f8 -
Trigger Event:
push
-
Statement type: