Import ErrorAll platformsPython 3.9 · 3.10 · 3.11 · 3.12

ImportError: cannot import name 'vanna' from 'vanna'

pip install vanna
>>> from vanna import vanna
ImportError: cannot import name 'vanna' from 'vanna'
(/usr/local/lib/python3.11/site-packages/vanna/__init__.py)

Vanna does not export a class named vanna. The package uses an adapter pattern — you compose a class by mixing a vector store and an LLM backend. There is no single top-level class to import.

Linux · Python 3.11
from vanna import vanna · failsadapter class · ok
macOS · Python 3.11
from vanna import vanna · failsadapter class · ok

1Use an adapter class (OpenAI + ChromaDB)Easiest

Pick the LLM + vector store combination you need. The most common starting point is OpenAI with ChromaDB.

pip install vanna[openai,chromadb]

from vanna.openai import OpenAI_Chat
from vanna.chromadb import ChromaDB_VectorStore

class MyVanna(ChromaDB_VectorStore, OpenAI_Chat):
    def __init__(self, config=None):
        ChromaDB_VectorStore.__init__(self, config=config)
        OpenAI_Chat.__init__(self, config=config)

vn = MyVanna(config={"api_key": "sk-...", "model": "gpt-4o"})
2Use VannaDefault for quick experimentsEasy

For a hosted demo without configuring a vector store, use the managed VannaDefault class.

from vanna.remote import VannaDefault
vn = VannaDefault(model="chinook", api_key="<your-key>")

vanna · Compatibility Matrix
See install results across all Python versions and operating systems
→
Observed in 39 searches · Last verified Aug 2026
ImportError: cannot import name 'vanna' from 'vanna' — vanna