Semantic Search with Cohere Embed Jobs

Semantic Search with Cohere Embed Jobs

import time
import cohere
import hnswlib
co = cohere.Client('COHERE_API_KEY')

Step 1: Upload a dataset

dataset_file_path = "data/embed_jobs_sample_data.jsonl" # Full path -

	data=open(dataset_file_path, 'rb'),
	keep_fields = ['id','wiki_id'],
uploading file, starting validation...
sample-file-hca4x0 was uploaded
cohere.Dataset {
	id: sample-file-hca4x0
	name: sample_file
	dataset_type: embed-input
	validation_status: validated
	created_at: 2024-01-13 02:51:48.215973
	updated_at: 2024-01-13 02:51:48.215973
	download_urls: ['']
	validation_error: None
	validation_warnings: []

Step 2: Create embeddings via Cohere's Embed Jobs endpoint

job = co.create_embed_job(,
    input_type='search_document' ,

job.wait() # poll the server until the job is completed 
cohere.EmbedJob {
	job_id: 792bbc1a-561b-48c2-8a97-0c80c1914ea8
	status: complete
	created_at: 2024-01-13T02:53:31.879719Z
	input_dataset_id: sample-file-hca4x0
	output_urls: None
	model: embed-english-v3.0
	truncate: RIGHT
	percent_complete: 100
	output: cohere.Dataset {
	id: embeded-sample-file-drtjf9
	name: embeded-sample-file
	dataset_type: embed-result
	validation_status: validated
	created_at: 2024-01-13 02:53:33.569362
	updated_at: 2024-01-13 02:53:33.569362
	download_urls: ['']
	validation_error: None
	validation_warnings: []

Step 3: Download and prepare the embeddings

embeddings_file_path = 'embed_jobs_output.csv'
output_dataset=co.get_dataset(, format="csv")
for record in output_dataset:

Step 4: Initialize Hnwslib index and add embeddings

index = hnswlib.Index(space='ip', dim=1024)
index.init_index(max_elements=len(embeddings), ef_construction=512, M=64)

Step 5: Query the index and rerank the results

query = "What was the first youtube video about?"

    texts=[query], model="embed-english-v3.0", input_type="search_query"

doc_index = index.knn_query(query_emb, k=10)[0][0]

docs_to_rerank = []
for index in doc_index:

final_result = co.rerank(
    query= query,

Step 6: Display the results

for idx, r in enumerate(final_result):
  print(f"Document Rank: {idx + 1}, Document Index: {r.index}")
  print(f"Document: {r.document['text']}")
  print(f"Relevance Score: {r.relevance_score:.5f}")
Document Rank: 1, Document Index: 0
Document: YouTube began as a venture capital–funded technology startup. Between November 2005 and April 2006, the company raised money from various investors, with Sequoia Capital, $11.5 million, and Artis Capital Management, $8 million, being the largest two. YouTube's early headquarters were situated above a pizzeria and a Japanese restaurant in San Mateo, California. In February 2005, the company activated codice_1. The first video was uploaded April 23, 2005. Titled "Me at the zoo", it shows co-founder Jawed Karim at the San Diego Zoo and can still be viewed on the site. In May, the company launched a public beta and by November, a Nike ad featuring Ronaldinho became the first video to reach one million total views. The site launched officially on December 15, 2005, by which time the site was receiving 8 million views a day. Clips at the time were limited to 100 megabytes, as little as 30 seconds of footage.
Relevance Score: 0.94815

Document Rank: 2, Document Index: 1
Document: Karim said the inspiration for YouTube first came from the Super Bowl XXXVIII halftime show controversy when Janet Jackson's breast was briefly exposed by Justin Timberlake during the halftime show. Karim could not easily find video clips of the incident and the 2004 Indian Ocean Tsunami online, which led to the idea of a video-sharing site. Hurley and Chen said that the original idea for YouTube was a video version of an online dating service, and had been influenced by the website Hot or Not. They created posts on Craigslist asking attractive women to upload videos of themselves to YouTube in exchange for a $100 reward. Difficulty in finding enough dating videos led to a change of plans, with the site's founders deciding to accept uploads of any video.
Relevance Score: 0.91626

Document Rank: 3, Document Index: 2
Document: YouTube was not the first video-sharing site on the Internet; Vimeo was launched in November 2004, though that site remained a side project of its developers from CollegeHumor at the time and did not grow much, either. The week of YouTube's launch, NBC-Universal's "Saturday Night Live" ran a skit "Lazy Sunday" by The Lonely Island. Besides helping to bolster ratings and long-term viewership for "Saturday Night Live", "Lazy Sunday"'s status as an early viral video helped establish YouTube as an important website. Unofficial uploads of the skit to YouTube drew in more than five million collective views by February 2006 before they were removed when NBCUniversal requested it two months later based on copyright concerns. Despite eventually being taken down, these duplicate uploads of the skit helped popularize YouTube's reach and led to the upload of more third-party content. The site grew rapidly; in July 2006, the company announced that more than 65,000 new videos were being uploaded every day and that the site was receiving 100 million video views per day.
Relevance Score: 0.90665