Skip to content
This repository has been archived by the owner on Jan 16, 2025. It is now read-only.

Add Quick Start to Readme #236

Draft
wants to merge 2 commits into
base: main
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
80 changes: 0 additions & 80 deletions .github/PULL_REQUEST_TEMPLATE/pull_request_template.yml

This file was deleted.

51 changes: 51 additions & 0 deletions .github/pull_request_template.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
# Pull Request

## Type of Change
Please select one:
- [ ] New notebook
- [ ] Notebook update
- [ ] Documentation update
- [ ] Environment/dependency update
- [ ] Other

## Description
[What changes does this PR make?]

## Testing
[Describe how you've verified these changes work]

### For Notebooks:
- Include a screen recording showing execution and outputs
- Or include screenshots of key outputs with explanation

### For Documentation:
- Preview any markdown changes
- Test any new links or references

## Notebook Changes Checklist
Complete if modifying notebooks:
- [ ] I have run the notebook from start to finish without errors
- [ ] I have cleared all cell outputs before committing
- [ ] I have included all required pip installations with pinned versions (e.g., pip install package==1.2.3) in %%sh cells at the start of the notebook
- [ ] I have included a screen recording or screenshots demonstrating the changes
- [ ] I have added sufficient markdown cells to explain the notebook's purpose and usage

## Documentation Changes Checklist
Complete if modifying documentation:
- [ ] I have checked for similar wording/style issues across all documentation
- [ ] I have verified all links and references still work
- [ ] I have previewed how the changes will appear
- [ ] I have followed the repository's documentation style guide (if applicable)

## Related Issues
[Add any related issue numbers (e.g., Fixes #123)]

---

> **Note for notebook submissions:**
> - Run the notebook in a fresh environment (e.g., new conda env or colab instance) to ensure all dependencies are captured
> - Comments should explain the purpose of non-obvious code blocks and any external data dependencies

> **Note for documentation updates:**
> - For minor changes, consider bundling multiple related improvements in one PR
> - Look for opportunities to improve similar sections across the documentation
41 changes: 32 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Cohere Examples
# Cohere Examples

Welcome! This repository provides a collection of examples to help you build LLM-powered applications with the [Cohere API](https://docs.cohere.com/). They contain step-by-step guides, with code examples and explanations, to help you understand and use the API effectively.

Expand All @@ -11,7 +11,30 @@ Interested to contribute? Read the [contributing guide](#contributing).

<br>

# Getting Started
## Quick Start

### Installation
```bash
# Install the Cohere Python SDK
pip install cohere

# Clone this repository
git clone https://github.com/cohere-ai/notebooks.git
cd notebooks
```

### Authentication
```python
import cohere
co = cohere.Client('your-api-key') # Get your API key from dashboard.cohere.ai
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

to add both options - v1 and v2, with v2 as the preferred one.

```

## Prerequisites
- Python 3.7 or higher
- A Cohere API key ([Sign up here](https://dashboard.cohere.ai))
- Familiarity with Jupyter notebooks

## Getting Started
This is a Cohere 101 guide. Build your first Cohere application: An onboarding assistant for new hires.
Duration: ~15 mins.

Expand All @@ -27,7 +50,7 @@ Duration: ~15 mins.

<br>

# LLM University
## LLM University
This section contains the code companion to the [LLM University](https://cohere.com/llmu) course containing a comprehensive list of modules.

| Module | Title | Colab |
Expand Down Expand Up @@ -68,7 +91,7 @@ This section contains the code companion to the [LLM University](https://cohere.

<br>

# Cookbook
## Cookbook
This section provides a deep dive into various techniques in the following topics:
- [RAG](#rag)
- [Agents](#agents)
Expand All @@ -79,7 +102,7 @@ This section provides a deep dive into various techniques in the following topic

<br>

## RAG
### RAG
| Title | Components | Colab |
|--------------------------------------------------------------|----------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------|
| [Basic RAG](https://github.com/cohere-ai/notebooks/blob/main/notebooks/Vanilla_RAG.ipynb) | Chat, Embed, Rerank | [<img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/>](https://colab.research.google.com/github/cohere-ai/notebooks/blob/main/notebooks/Vanilla_RAG.ipynb) |
Expand All @@ -92,7 +115,7 @@ This section provides a deep dive into various techniques in the following topic
| [Adaptive RAG](https://github.com/cohere-ai/notebooks/blob/main/notebooks/agents/Multi_Step_Tool_Use.ipynb) | Chat, LangChain | [<img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/>](https://colab.research.google.com/github/cohere-ai/notebooks/blob/main/notebooks/agents/Multi_Step_Tool_Use.ipynb) |


## Agents
### Agents

| Title | Components | Colab |
|--------------------------------------------------------------|--------------------------------|-----------------|
Expand Down Expand Up @@ -120,15 +143,15 @@ This section provides a deep dive into various techniques in the following topic
| [Wikipedia Semantic Search with Cohere + Weaviate](https://github.com/cohere-ai/notebooks/blob/main/notebooks/guides/Wikipedia_search_demo_cohere_weaviate.ipynb) | Embed, Weaviate | <a target="_blank" href="https://colab.research.google.com/github/cohere-ai/notebooks/blob/main/notebooks/guides/Wikipedia_search_demo_cohere_weaviate.ipynb"> <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/> |


## Summarization
### Summarization
| Title | Components | Colab |
|--------------------------------------------------------------|---------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Long Form General Strategies](https://github.com/cohere-ai/notebooks/blob/main/notebooks/guides/Long_form_General_Strategies.ipynb) | Chat, Embed, Rerank | <a target="_blank" href="https://colab.research.google.com/github/cohere-ai/notebooks/blob/main/notebooks/guides/Long_form_General_Strategies.ipynb"> <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/> </a> |
| [Summarization Evals](https://github.com/cohere-ai/notebooks/blob/main/notebooks/guides/Summarization_Evals.ipynb) | Chat | <a target="_blank" href="https://colab.research.google.com/github/cohere-ai/notebooks/blob/main/notebooks/guides/Summarization_Evals.ipynb"> <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/> </a> |
| [Grounded Summarization Using Command R](https://github.com/cohere-ai/notebooks/blob/main/notebooks/guides/Grounded_summarisation_using_Command_R.ipynb) | Chat, Embed | <a target="_blank" href="https://colab.research.google.com/github/cohere-ai/notebooks/blob/main/notebooks/guides/Grounded_summarisation_using_Command_R.ipynb"> <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/> </a> |


## Others
### Others
| Title | Components | Colab |
|--------------------------------------------------------------|-----------------------|------------------------------------------------------------------------|
| [Advanced Document Parsing For Enterprises](https://github.com/cohere-ai/notebooks/blob/main/notebooks/guides/Document_Parsing_For_Enterprises.ipynb) | Chat, Embed, Rerank | <a target="_blank" href="https://colab.research.google.com/github/cohere-ai/notebooks/blob/main/notebooks/guides/Document_Parsing_For_Enterprises.ipynb"> <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/> |
Expand All @@ -140,7 +163,7 @@ This section provides a deep dive into various techniques in the following topic

<br>

# Contributing
## Contributing
Thank you for your interest in contributing! We appreciate your input and encourage you to share your ideas and improvements. Here are some ways you can contribute:

- New Examples and Guides: If you have an idea for a new example or guide, please share it with us! Create an issue to discuss your proposal, gather feedback, and get started. This ensures your contribution aligns with the project's scope and avoids duplication.
Expand Down