Skip to main content

A toolset for agentic workflows

Project description

agentic-tools

A python package that lets you setup agents with tools very easy

drawing

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agentic_tools-0.2.0.tar.gz (5.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agentic_tools-0.2.0-py3-none-any.whl (5.5 kB view details)

Uploaded Python 3

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

Hashes for agentic_tools-0.2.0.tar.gz
Algorithm Hash digest
SHA256 c4747dc3894808a5e83b6f50ca1d29cec26095cdb7e6b3cc04d114236f123ea9
MD5 afc58b2a7ebb731387957c2458e1d488
BLAKE2b-256 09bb4aa1e252e18a6c5561f465fc010c84ac44439fafde02192808c040d35520

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentic_tools-0.2.0.tar.gz:

Publisher: release.yaml on AxelGard/agentic-tools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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

Hashes for agentic_tools-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 29f9e94ddf86a30b3b3f016d5a545c1fcee409ece6a8d4e69ed143748b9337d0
MD5 18973f7de880d2a3e245bb4d001ed30f
BLAKE2b-256 d3e7b978827e729151f0be6ff45345f01d7dfc58dbd29065a09a3b91e42e70ef

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentic_tools-0.2.0-py3-none-any.whl:

Publisher: release.yaml on AxelGard/agentic-tools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page