iBet uBet web content aggregator. Adding the entire web to your favor.
iBet uBet web content aggregator. Adding the entire web to your favor.



Link to original content: https://badge.fury.io/py/autollm
autollm · PyPI Skip to main content

Ship RAG based LLM Web API's, in seconds.

Project description

🤔 why autollm?

Simplify. Unify. Amplify.

Feature AutoLLM LangChain LlamaIndex LiteLLM
100+ LLMs
Unified API
20+ Vector Databases
Cost Calculation (100+ LLMs)
1-Line RAG LLM Engine
1-Line FastAPI

📦 installation

easily install autollm package with pip in Python>=3.8 environment.

pip install autollm

for built-in data readers (github, pdf, docx, ipynb, epub, mbox, websites..), install with:

pip install autollm[readers]

🎯 quickstart

tutorials

create a query engine in seconds

>>> from autollm import AutoQueryEngine, read_files_as_documents

>>> documents = read_files_as_documents(input_dir="path/to/documents")
>>> query_engine = AutoQueryEngine.from_defaults(documents)

>>> response = query_engine.query(
...     "Why did SafeVideo AI develop this project?"
... )

>>> response.response
"Because they wanted to deploy rag based llm apis in no time!"
👉 advanced usage
>>> from autollm import AutoQueryEngine

>>> query_engine = AutoQueryEngine.from_defaults(
...     documents=documents,
...     llm_model="gpt-3.5-turbo",
...     llm_max_tokens="256",
...     llm_temperature="0.1",
...     system_prompt='...',
...     query_wrapper_prompt='...',
...     enable_cost_calculator=True,
...     embed_model="huggingface/BAAI/bge-large-zh",
...     chunk_size=512,
...     chunk_overlap=64,
...     context_window=4096,
...     similarity_top_k=3,
...     response_mode="compact",
...     structured_answer_filtering=False,
...     vector_store_type="LanceDBVectorStore",
...     lancedb_uri="./lancedb",
...     lancedb_table_name="vectors",
...     exist_ok=True,
...     overwrite_existing=False,
... )

>>> response = query_engine.query("Who is SafeVideo AI?")

>>> print(response.response)
"A startup that provides self hosted AI API's for companies!"

convert it to a FastAPI app in 1-line

>>> import uvicorn

>>> from autollm import AutoFastAPI

>>> app = AutoFastAPI.from_query_engine(query_engine)

>>> uvicorn.run(app, host="0.0.0.0", port=8000)
INFO:    Started server process [12345]
INFO:    Waiting for application startup.
INFO:    Application startup complete.
INFO:    Uvicorn running on http://http://0.0.0.0:8000/
👉 advanced usage
>>> from autollm import AutoFastAPI

>>> app = AutoFastAPI.from_query_engine(
...      query_engine,
...      api_title='...',
...      api_description='...',
...      api_version='...',
...      api_term_of_service='...',
    )

>>> uvicorn.run(app, host="0.0.0.0", port=8000)
INFO:    Started server process [12345]
INFO:    Waiting for application startup.
INFO:    Application startup complete.
INFO:    Uvicorn running on http://http://0.0.0.0:8000/

🌟 features

supports 100+ LLMs

>>> from autollm import AutoQueryEngine

>>> os.environ["HUGGINGFACE_API_KEY"] = "huggingface_api_key"

>>> llm_model = "huggingface/WizardLM/WizardCoder-Python-34B-V1.0"
>>> llm_api_base = "https://my-endpoint.huggingface.cloud"

>>> AutoQueryEngine.from_defaults(
...     documents='...',
...     llm_model=llm_model,
...     llm_api_base=llm_api_base,
... )
👉 more llms:
  • huggingface - ollama example:

    >>> from autollm import AutoQueryEngine
    
    >>> llm_model = "ollama/llama2"
    >>> llm_api_base = "http://localhost:11434"
    
    >>> AutoQueryEngine.from_defaults(
    ...     documents='...',
    ...     llm_model=llm_model,
    ...     llm_api_base=llm_api_base,
    ... )
    
  • microsoft azure - openai example:

    >>> from autollm import AutoQueryEngine
    
    >>> os.environ["AZURE_API_KEY"] = ""
    >>> os.environ["AZURE_API_BASE"] = ""
    >>> os.environ["AZURE_API_VERSION"] = ""
    
    >>> llm_model = "azure/<your_deployment_name>")
    
    >>> AutoQueryEngine.from_defaults(
    ...     documents='...',
    ...     llm_model=llm_model
    ... )
    
  • google - vertexai example:

    >>> from autollm import AutoQueryEngine
    
    >>> os.environ["VERTEXAI_PROJECT"] = "hardy-device-38811"  # Your Project ID`
    >>> os.environ["VERTEXAI_LOCATION"] = "us-central1"  # Your Location
    
    >>> llm_model = "text-bison@001"
    
    >>> AutoQueryEngine.from_defaults(
    ...     documents='...',
    ...     llm_model=llm_model
    ... )
    
  • aws bedrock - claude v2 example:

    >>> from autollm import AutoQueryEngine
    
    >>> os.environ["AWS_ACCESS_KEY_ID"] = ""
    >>> os.environ["AWS_SECRET_ACCESS_KEY"] = ""
    >>> os.environ["AWS_REGION_NAME"] = ""
    
    >>> llm_model = "anthropic.claude-v2"
    
    >>> AutoQueryEngine.from_defaults(
    ...     documents='...',
    ...     llm_model=llm_model
    ... )
    

supports 20+ VectorDBs

🌟Pro Tip: autollm defaults to lancedb as the vector store: it's setup-free, serverless, and 100x more cost-effective!

👉 more vectordbs:
  • QdrantVectorStore example:
    >>> from autollm import AutoQueryEngine
    >>> import qdrant_client
    
    >>> vector_store_type = "QdrantVectorStore"
    >>> client = qdrant_client.QdrantClient(
    ...     url="http://<host>:<port>",
    ...     api_key="<qdrant-api-key>"
    ... )
    >>> collection_name = "quickstart"
    
    >>> AutoQueryEngine.from_defaults(
    ...     documents='...',
    ...     vector_store_type=vector_store_type,
    ...     client=client,
    ...     collection_name=collection_name,
    ... )
    

automated cost calculation for 100+ LLMs

>>> from autollm import AutoServiceContext

>>> service_context = AutoServiceContext(enable_cost_calculation=True)

# Example verbose output after query
Embedding Token Usage: 7
LLM Prompt Token Usage: 1482
LLM Completion Token Usage: 47
LLM Total Token Cost: $0.002317

create FastAPI App in 1-Line

👉 example
>>> from autollm import AutoFastAPI

>>> app = AutoFastAPI.from_config(config_path, env_path)

Here, config and env should be replaced by your configuration and environment file paths.

After creating your FastAPI app, run the following command in your terminal to get it up and running:

uvicorn main:app

🔄 migration from llama-index

switching from Llama-Index? We've got you covered.

👉 easy migration
>>> from llama_index import StorageContext, ServiceContext, VectorStoreIndex
>>> from llama_index.vectorstores import LanceDBVectorStore

>>> from autollm import AutoQueryEngine

>>> vector_store = LanceDBVectorStore(uri="./.lancedb")
>>> storage_context = StorageContext.from_defaults(vector_store=vector_store)
>>> service_context = ServiceContext.from_defaults()
>>> index = VectorStoreIndex.from_documents(
        documents=documents,
        storage_context=storage_contex,
        service_context=service_context,
    )

>>> query_engine = AutoQueryEngine.from_instances(index)

❓ FAQ

Q: Can I use this for commercial projects?

A: Yes, AutoLLM is licensed under GNU Affero General Public License (AGPL 3.0), which allows for commercial use under certain conditions. Contact us for more information.


roadmap

our roadmap outlines upcoming features and integrations to make autollm the most extensible and powerful base package for large language model applications.

  • 1-line Gradio app creation and deployment

  • Budget based email notification

  • Automated LLM evaluation

  • Add more quickstart apps on pdf-chat, documentation-chat, academic-paper-analysis, patent-analysis and more!


📜 license

autollm is available under the GNU Affero General Public License (AGPL 3.0).


📞 contact

for more information, support, or questions, please contact:


🏆 contributing

love autollm? star the repo or contribute and help us make it even better! see our contributing guidelines for more information.


follow us for more!

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

autollm-0.1.10.tar.gz (45.1 kB view details)

Uploaded Source

Built Distribution

autollm-0.1.10-py3-none-any.whl (47.1 kB view details)

Uploaded Python 3

File details

Details for the file autollm-0.1.10.tar.gz.

File metadata

  • Download URL: autollm-0.1.10.tar.gz
  • Upload date:
  • Size: 45.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.12.1

File hashes

Hashes for autollm-0.1.10.tar.gz
Algorithm Hash digest
SHA256 d912139c0fb411ec8611422d1e994d4b47687c29ce3a8f94dbdee18b885d005a
MD5 8981c79381bfddfd0b5bd010076730da
BLAKE2b-256 9b6249fa2a2eaf97b777643b795f5f5eddc7f48b3dba7c59f8dd1ee640046d86

See more details on using hashes here.

File details

Details for the file autollm-0.1.10-py3-none-any.whl.

File metadata

  • Download URL: autollm-0.1.10-py3-none-any.whl
  • Upload date:
  • Size: 47.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.12.1

File hashes

Hashes for autollm-0.1.10-py3-none-any.whl
Algorithm Hash digest
SHA256 4b6a59aae08320b85f126d2a6c8159d44bb6d1fa9f922918f9145725f93355ac
MD5 3e92368d14c2cd2b685aa7bb28bb3fd2
BLAKE2b-256 ea540a0f9475516886d6d0e264607197ad1e00841edd9bf0b386bfef72a8863e

See more details on using hashes here.

Supported by

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