{"id":21536,"library":"llama-index-readers-jira","title":"LlamaIndex Jira Reader","description":"A LlamaIndex reader for loading data from Jira issues. Provides tools to fetch issues using JQL queries and convert them into documents for indexing. Current version: 0.6.0, requires Python >=3.10, <4.0. Active development with frequent releases.","status":"active","version":"0.6.0","language":"python","source_language":"en","source_url":"https://github.com/run-llama/llama_index","tags":["llamaindex","jira","reader","document-loader","rag"],"install":[{"cmd":"pip install llama-index-readers-jira","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Required for base reader classes and document types","package":"llama-index-core","optional":false},{"reason":"Python Jira client for API interaction","package":"jira","optional":false}],"imports":[{"note":"Direct import from the package's top-level module; using .base was an older pattern that may break in newer versions.","wrong":"from llama_index.readers.jira.base import JiraReader","symbol":"JiraReader","correct":"from llama_index.readers.jira import JiraReader"}],"quickstart":{"code":"import os\nfrom llama_index.readers.jira import JiraReader\n\n# Set environment variables or pass directly\nreader = JiraReader(\n    email=os.environ.get('JIRA_EMAIL', ''),\n    api_token=os.environ.get('JIRA_API_TOKEN', ''),\n    server_url=os.environ.get('JIRA_SERVER_URL', '')\n)\n# Load issues using JQL\ndocuments = reader.load_data(\n    query='project = MYPROJ AND status in (\"In Progress\", \"Done\")',\n    max_results=50\n)\nprint(f\"Loaded {len(documents)} documents\")","lang":"python","description":"Basic usage: initialize JiraReader with credentials and JQL query to load issues as documents."},"warnings":[{"fix":"Always provide server_url: either via env var or parameter.","message":"If you do not set the JIRA_SERVER_URL environment variable or pass it explicitly, the reader defaults to 'https://your-domain.atlassian.net' which may fail if your server is custom.","severity":"gotcha","affected_versions":"all"},{"fix":"Use `from llama_index.readers.jira import JiraReader`.","message":"Older versions used `from llama_index.readers.jira.base import JiraReader`. This path is deprecated; use the top-level package path instead.","severity":"deprecated","affected_versions":">=0.2.0"},{"fix":"Update code to handle Jira issue dicts from the `jira` library. Check the reader's output format.","message":"In version 0.6.0, the reader now uses the `jira` library directly instead of `atlassian-python-api`. If you have code that relied on `atlassian` objects, it will break.","severity":"breaking","affected_versions":"0.6.0"},{"fix":"To access raw issue data, use the `load_data` return value text parsing, or use the `jira` library directly.","message":"The `load_data` method returns a list of Document objects, not raw Jira issues. Each Document's text contains issue fields concatenated.","severity":"gotcha","affected_versions":"all"},{"fix":"Replace with JIRA_EMAIL and JIRA_API_TOKEN.","message":"Authentication via JIRA_USERNAME and JIRA_PASSWORD env vars is deprecated; use JIRA_API_TOKEN instead.","severity":"deprecated","affected_versions":">=0.4.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Install with `pip install llama-index-readers-jira` and ensure import path is `from llama_index.readers.jira import JiraReader`.","cause":"The library is not installed or the import path is wrong.","error":"ModuleNotFoundError: No module named 'llama_index.readers.jira'"},{"fix":"Check JIRA_EMAIL and JIRA_API_TOKEN environment variables or pass them to the constructor.","cause":"Invalid or missing authentication credentials (email/token).","error":"jira.exceptions.JIRAError: JiraError HTTP 401 url: https://your-domain.atlassian.net/rest/api/2/search"},{"fix":"Upgrade to latest version: `pip install --upgrade llama-index-readers-jira`. If tied to older version, check docs for `load_data` alternative.","cause":"Using an outdated version of the library (pre-0.2.0) where method was named differently.","error":"AttributeError: 'JiraReader' object has no attribute 'load_data'"},{"fix":"Upgrade to 0.4.0+ and use email+api_token, or downgrade to use username+password.","cause":"Using an older version (<0.4.0) that did not support API token auth.","error":"TypeError: JiraReader.__init__() got an unexpected keyword argument 'api_token'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}