langchain-taiga

This package provides Taiga tools and a toolkit for use with LangChain. It includes:

create_entity_tool: Creates user stories, tasks and issues in Taiga.
search_entities_tool: Searches for user stories, tasks and issues in Taiga.
get_entity_by_ref_tool: Gets a user story, task or issue by reference.
update_entity_by_ref_tool: Updates a user story, task or issue by reference.
add_comment_by_ref_tool: Adds a comment to a user story, task or issue.
add_attachment_by_ref_tool: Adds an attachment to a user story, task or issue.

Installation

pip install -U langchain-taiga

Environment Variable

Export your taiga logins:

export TAIGA_URL="https://taiga.xyz.org/"
export TAIGA_API_URL="https://taiga.xyz.org/"
export TAIGA_USERNAME="username"
export TAIGA_PASSWORD="pw"
export OPENAI_API_KEY="OPENAI_API_KEY"

If this environment variable is not set, the tools will raise a ValueError when instantiated.

Usage

Direct Tool Usage

from langchain_taiga.tools.taiga_tools import create_entity_tool, search_entities_tool, get_entity_by_ref_tool, update_entity_by_ref_tool, add_comment_by_ref_tool, add_attachment_by_ref_tool

response = create_entity_tool({"project_slug": "slug",
                       "entity_type": "us",
                       "subject": "subject",
                       "status": "new",
                       "description": "desc",
                       "parent_ref": 5,
                       "assign_to": "user",
                       "due_date": "2022-01-01",
                       "tags": ["tag1", "tag2"]})

response = search_entities_tool({"project_slug": "slug", "query": "query", "entity_type": "task"})

response = get_entity_by_ref_tool({"entity_type": "user_story", "project_id": 1, "ref": "1"})

response = update_entity_by_ref_tool({"project_slug": "slug", "entity_ref": 555, "entity_type": "us"})

response = add_comment_by_ref_tool({"project_slug": "slug", "entity_ref": 3, "entity_type": "us",
                "comment": "new"})

response = add_attachment_by_ref_tool({"project_slug": "slug", "entity_ref": 3, "entity_type": "us",
                "attachment_url": "url", "content_type": "png", "description": "desc"})

Using the Toolkit

You can also use TaigaToolkit to automatically gather both tools:

from langchain_taiga.toolkits import TaigaToolkit

toolkit = TaigaToolkit()
tools = toolkit.get_tools()

Tests

If you have a tests folder (e.g. tests/unit_tests/), you can run them (assuming Pytest) with:

pytest --maxfail=1 --disable-warnings -q

License

MIT License

Further Documentation

For more details, see the docstrings in:
- taiga_tools.py
- toolkits.py for TaigaToolkit
Official Taiga Developer Docs: https://docs.taiga.io/api.html
LangChain GitHub for general LangChain usage and tooling.

Metadata

Release files for langchain-taiga 1.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for langchain-taiga 1.0.3
File	Size	Uploaded
langchain_taiga-1.0.3.tar.gz	11.9 kB	Apr 19, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for langchain-taiga 1.0.3
File	Interpreter	ABI	Platform	Reset
langchain_taiga-1.0.3-py3-none-any.whl 12.2 kB Apr 19, 2025	Python 3	none	any	Details

Total release size: 24.1 kB

Release files / langchain_taiga-1.0.3.tar.gz

Download URL	langchain_taiga-1.0.3.tar.gz
Size	11.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`903ea3571dd8488b83e12d8eaa21a4080371413be78b1758133e3a2aea458b5e`
BLAKE2b-256 checksum How to use checksums	`bbb602938f0db1b27fe484200dfdda9f794297cc22f9691fefa3a7ab66fc5af7`
Upload date	Apr 19, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.12.9`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Shikenso-Analytics/langchain-taiga
Publishing commit: github.com/Shikenso-Analytics/langchain-taiga/tree/ad117fa4b40b189b9a51b49a85a9e5f6688183e1

Workflow

Publishing configuration: github.com/Shikenso-Analytics/langchain-taiga/blob/ad117fa4b40b189b9a51b49a85a9e5f6688183e1/.github/workflows/ci_publish.yml
Publishing logs: github.com/Shikenso-Analytics/langchain-taiga/actions/runs/14547097627/attempts/1

Artifact

Subject: langchain_taiga-1.0.3.tar.gz
SHA-256 checksum: 903ea3571dd8488b83e12d8eaa21a4080371413be78b1758133e3a2aea458b5e Verifying attestations

Release files / langchain_taiga-1.0.3-py3-none-any.whl

Download URL	langchain_taiga-1.0.3-py3-none-any.whl
Size	12.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`e0c9c98dac51a9e08fe0f67552674938fe6c34b2e8ae63017ab94ff50a55955d`
BLAKE2b-256 checksum How to use checksums	`cf60d3a2e57bca41f1750dd9c48019636429fb40a8e850d5397ac2364f6f037b`
Upload date	Apr 19, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.12.9`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Shikenso-Analytics/langchain-taiga
Publishing commit: github.com/Shikenso-Analytics/langchain-taiga/tree/ad117fa4b40b189b9a51b49a85a9e5f6688183e1

Workflow

Publishing configuration: github.com/Shikenso-Analytics/langchain-taiga/blob/ad117fa4b40b189b9a51b49a85a9e5f6688183e1/.github/workflows/ci_publish.yml
Publishing logs: github.com/Shikenso-Analytics/langchain-taiga/actions/runs/14547097627/attempts/1

Artifact

Subject: langchain_taiga-1.0.3-py3-none-any.whl
SHA-256 checksum: e0c9c98dac51a9e08fe0f67552674938fe6c34b2e8ae63017ab94ff50a55955d Verifying attestations