Skip to content
This repository has been archived by the owner on Nov 13, 2024. It is now read-only.

[WIP] Readme v0.1 canopy #86

Merged
merged 39 commits into from
Oct 24, 2023
Merged

[WIP] Readme v0.1 canopy #86

merged 39 commits into from
Oct 24, 2023

Conversation

miararoy
Copy link
Contributor

Problem

Describe the purpose of this change. What problem is being solved and why?

Solution

Describe the approach you took. Link to any relevant bugs, issues, docs, or other resources.

Type of Change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • This change requires a documentation update
  • Infrastructure change (CI configs, etc)
  • Non-code change (docs, etc)
  • None of the above: (explain here)

Test Plan

Describe specific steps for validating this change.

@miararoy miararoy changed the title Readme v0.1 canopy [WIP] Readme v0.1 canopy Oct 20, 2023
resin/__init__.py Outdated Show resolved Hide resolved
Copy link
Contributor

Choose a reason for hiding this comment

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

Remove from this branch

README.md Outdated Show resolved Hide resolved
README.md Outdated
Comment on lines 15 to 17
* **ChatEngine** - is a complete RAG unit that exposes a chat interface of LLM augmented with retrieval engine.
* **ContextEngine** - is a proxy between your application and Pinecone. It will handle the R in the RAG pipeline and will return the snippet of context along with the respected source.
* **KnowledgeBase** - is the data managment interface, handles the processing, chunking and encoding (embedding) of the data, along with Upsert/Query and Delete operations
Copy link
Contributor

Choose a reason for hiding this comment

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

Remove and put a link to Amnon's sub-page

README.md Outdated Show resolved Hide resolved
README.md Outdated

Where:
3. **Resin CLI** - Resin comes with a fully functional CLI that is purposley built to allow users to quickly test their configuration and application before shipping, the CLI also comes with managment operations that allow you to create indexes and load data quickly
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
3. **Resin CLI** - Resin comes with a fully functional CLI that is purposley built to allow users to quickly test their configuration and application before shipping, the CLI also comes with managment operations that allow you to create indexes and load data quickly
3. **Resin CLI** - Fully functional development tool that allow users to quickly create a Resin service using their own documents, then test application before shipping to production.
The CLI allows to create a new resin service with a single command, upload your own documents to it and test the application's responses using a built-in terminal based chat app.

README.md Outdated Show resolved Hide resolved
Comment on lines +139 to +140
> The resin start command will keep the terminal occupied. To proceed with the next steps, please open a new terminal window.
> and make sure all the environment variables described in the [installation](#how-to-install) section are set.
Copy link
Contributor

@igiloh-pinecone igiloh-pinecone Oct 23, 2023

Choose a reason for hiding this comment

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

Suggested change
> The resin start command will keep the terminal occupied. To proceed with the next steps, please open a new terminal window.
> and make sure all the environment variables described in the [installation](#how-to-install) section are set.
> The resin start command will keep the terminal occupied, allowing for quickly stoping the service by hitting `Ctrl-C`. Alternatively, you can run the `resin stop` command from any window to shutdown the resin service, which would release the shell.
If you'd like to try the terminal-based demo chat tool - please run `resin chat` in a new terminal window.

Copy link
Contributor

@igiloh-pinecone igiloh-pinecone left a comment

Choose a reason for hiding this comment

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

@miararoy please see two changes (not to the readme itself)

pyproject.toml Outdated
@@ -64,5 +65,5 @@ per-file-ignores = [
max-line-length = 88

[tool.poetry.scripts]
resin = "resin_cli.cli:cli"
canopy = "resin_cli.cli:cli"
Copy link
Contributor

Choose a reason for hiding this comment

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

Remove from this branch

@@ -23,6 +23,7 @@ uvicorn = "^0.20.0"
tenacity = "^8.2.1"
sse-starlette = "^1.6.5"
types-tqdm = "^4.61.0"
tqdm = "^4.66.1"
Copy link
Contributor

Choose a reason for hiding this comment

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

Wait - isn't tqdm already a dependency???

If it isn't - please push as a separate PR

@@ -1,55 +1,110 @@
# Resin

**Resin** is a tool that allows you to build AI applications using your own data. It is built on top of Pinecone, the world's most powerfull vector database. **Resin** is desinged to be well packaged and easy to use. It can be used as a library or as a service. It is also designed to be modular, so you can use only the parts that you need. **Resin** is built with the following principles in mind:
**Resin** is a Sofware Development Kit (SDK) for AI applications. Resin allows you to test, build and package Retrieval Augmented Applications with Pinecone Vector Database. **Resin** is desinged to be well packaged and easy to use. It can be used as-a-library or as-a-service and designed to be modular, so you can use only the parts that you need. **Resin** ships with a developer friendly CLI, to help you kickoff and test your application quickly.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
**Resin** is a Sofware Development Kit (SDK) for AI applications. Resin allows you to test, build and package Retrieval Augmented Applications with Pinecone Vector Database. **Resin** is desinged to be well packaged and easy to use. It can be used as-a-library or as-a-service and designed to be modular, so you can use only the parts that you need. **Resin** ships with a developer friendly CLI, to help you kickoff and test your application quickly.
**Resin** is a Sofware Development Kit (SDK) for AI applications. Resin allows you to test, build and package Retrieval Augmented Applications with Pinecone Vector Database.
**Resin** is designed to be well packaged and easy to use. It can be used as-a-library or as-a-service and designed to be modular, so you can use only the parts that you need.
**Resin** ships with a developer friendly CLI, to help you kickoff and test your application quickly.

Using double spaces in md allows you to drop the paragraph to a new line, which looks better

|----------+--------------+--------------+---------------|
| "1" | "some text" | "some source"| {"key": "val"}|
| "id1" | "some text" | "some source"| {"key": "val"}|
Copy link
Contributor

Choose a reason for hiding this comment

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

@miararoy you need to remove the ``` from this table. It prevents it from being rendered as an actual MD table

@igiloh-pinecone igiloh-pinecone marked this pull request as ready for review October 24, 2023 18:29
@igiloh-pinecone igiloh-pinecone merged commit aa9e7e6 into dev Oct 24, 2023
4 checks passed
@igiloh-pinecone igiloh-pinecone deleted the readme-v0.1-canopy branch October 24, 2023 18:29
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants