# Tutorials

The following examples showcase many typical use cases of how to use the Imagine SDK.
The code snippets are designed so that you can copy-paste and run them on your
environment.

````{only} internal
You can also find these same examples and more on
the [Imagine SDK repository](https://github.qualcomm.com/edaap/imagine-sdk-python/tree/main/examples).
````

::::{grid} 2
:gutter: 2

:::{grid-item-card} {octicon}`rocket;1em;sd-text-info` Basic usage
:link: 1_0_basic_usage
:link-type: doc
The tutorials about how to use the Imagine clients are a good
starting point to unlock the potential of Imagine.
:::

:::{grid-item-card} {octicon}`tools;1em;sd-text-info` Tool calling
:link: 2_0_tool_calling
:link-type: doc
The tutorials about how to use the Tool Calling using Imagine clients
:::


:::{grid-item-card} {octicon}`link;1em;sd-text-info` LangChain
:link: 3_0_langchain
:link-type: doc
If you are familiar with [LangChain](https://www.langchain.com/), have a look at the LangChain examples.
:::

:::{grid-item-card} {octicon}`note;1em;sd-text-info` RAG
:link: rag_with_chromadb
:link-type: doc
How the Imagine SDK can be used with LangChain for retrieval-augmented generation.
:::

:::{grid-item-card} {octicon}`note;1em;sd-text-info` LiteLLM
:link: litellm
:link-type: doc
How to use liteLLM to make API calls with Imagine
:::

:::{grid-item-card} {octicon}`dependabot;1em;sd-text-info` Agents
:link: crewai
:link-type: doc
Use agentic frameworks like [crewAI](https://www.crewai.com/) and [Autogen](https://microsoft.github.io/autogen/0.2/) to orchestrate powerful workflows.
:::


:::{grid-item-card} {octicon}`shield-check;1em;sd-text-info` Guarded LLM
:link: guarded_llm_example
:link-type: doc
How to introduce input and output guardrails.
:::

:::{grid-item-card} {octicon}`log;1em;sd-text-info` Logging
:link: 6_0_logging
:link-type: doc
How to enable logging.
:::

::::


## Table of contents

```{toctree}
1_0_basic_usage
2_0_tool_calling
3_0_langchain
litellm
crewai
autogen
rag_with_chromadb
guarded_llm_example
6_0_logging
```