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?

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.1.tar.gz (5.0 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.1-py3-none-any.whl (5.1 kB view details)

Uploaded Python 3

File details

Details for the file agentic_tools-0.2.1.tar.gz.

File metadata

  • Download URL: agentic_tools-0.2.1.tar.gz
  • Upload date:
  • Size: 5.0 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.1.tar.gz
Algorithm Hash digest
SHA256 034b39ab03332c49762bd7dd1edfdfffe36c9a0392cdaeed695f48eca7ee9aad
MD5 2938eb6bb90215a77095cc581a7bbcb6
BLAKE2b-256 ccc9232ee8b14c78f7f9bda22f599b6ec99c6aaea91326cc4a2400cbe7589703

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentic_tools-0.2.1.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.1-py3-none-any.whl.

File metadata

  • Download URL: agentic_tools-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 5.1 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 1821309fd1ab8a34ea98367e12265ec6169635635ab7020fe65ce40eeabfa4ce
MD5 9f8b799f40fd69f086d839bc30ad00a9
BLAKE2b-256 1ca014702a857a32cf02f8a24513eba1b45ad005c305c7de6ce94b03a4a0625c

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentic_tools-0.2.1-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