diff --git a/README.md b/README.md
index 0c974e0c..72a39e40 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# instill-core
+# 🔮 **Instill Core**
[](https://github.com/instill-ai/instill-core/actions/workflows/integration-test-latest.yml?branch=main&event=push)
[](https://github.com/instill-ai/instill-core/releases)
@@ -7,66 +7,58 @@
[](#contributors-)
-Explore **🔮 [Instill Core](https://github.com/instill-ai/instill-core)**, a full-stack AI infrastructure tool for data, model and pipeline orchestration, designed to streamline every aspect of building versatile AI-first applications. Accessing **🔮 Instill Core** is straightforward, whether you opt for **☁️ Instill Cloud** or self-hosting via the [instill-core](https://github.com/instill-ai/instill-core) repository. Please consult the [documentation](https://www.instill.tech/docs/latest/core/deployment/?utm_source=github&utm_medium=readme&utm_campaign=org_readme) for more details.
-
-
-
-
-
-
-
-
-
-
-
- 💧 Instill VDP - Pipeline orchestration for unstructured data ETL
-
-
+✨ Make your unstructured data **AI-ready** FAST & build unique versatile **AI-first** applications EASILY. ✨
- **💧 Instill VDP**, also known as **VDP (Versatile Data Pipeline)**, serves as a powerful pipeline orchestration tool tailored to address unstructured data ETL challenges.
+## Quick start
-
+There are a few ways to start exploring:
- **⚙️ Instill Component** is an extensible integration framework that enhances **💧 Instill VDP**, unlocking limitless possibilities. Please visit the [component](https://github.com/instill-ai/pipeline-backend/blob/main/pkg/component) package for details.
+1. **[Instill Cloud](https://instill.tech/featured/pipelines/?utm_source=github&utm_medium=readme&utm_campaign=org_readme)**: Explore our public cloud powered by [Instill Core](https://github.com/instill-ai/instill-core) with ready-to-use APIs, automations, AI Assistants and more. See the [quickstart](https://www.instill.tech/docs/quickstart#%EF%B8%8F-instill-cloud) on how to get started.
+2. **Self-hosting Instill Core**: Follow the [installation](#installation) steps below or [documentation](https://www.instill.tech/docs/latest/core/deployment/?utm_source=github&utm_medium=readme&utm_campaign=org_readme) for more details to build versatile AI applications locally.
-
-
- ⚗️ Instill Model - Model orchestration for MLOps/LLMOps
+## What is Instill Core?
-
+**[Instill Core](https://github.com/instill-ai/instill-core)** is your end-to-end AI platform for data, pipeline and model orchestration.
- **⚗️ Instill Model** is an advanced MLOps/LLMOps platform focused on seamlessly model serving, fine-tuning, and monitoring for persistent performance for unstructured data ETL.
-
-
-
- 💾 Instill Artifact - Data orchestration for unified unstructured data representation
+
+
+
+
+
+
+
-
+**Instill Core** simplifies infrastructure hassle and encompasses these core features:
- **💾 Instill Artifact** orchestrates unstructured data to transform documents (e.g., HTML, PDF, CSV, PPTX, DOC), images (e.g., JPG, PNG, TIFF), audio (e.g., WAV, MP3 ) and video (e.g., MP4, MOV) into a unified AI-ready format. It ensures your data is clean, curated, and ready for extracting insights and building your Knowledge Base.
-
+- **DATA - [Instill Artifact](https://www.instill.tech/docs/artifact/introduction//?utm_source=github&utm_medium=readme&utm_campaign=org_readme)**: Transforms unstructured data (documents, images, audio, video) into AI-ready formats.
+- **PIPELINE - [Instill VDP](https://www.instill.tech/docs/vdp/introduction//?utm_source=github&utm_medium=readme&utm_campaign=org_readme)**: Quickly build any versatile AI-first APIs or automated workflows.
+- **MODEL - [Instill Model](https://www.instill.tech/docs/model/introduction//?utm_source=github&utm_medium=readme&utm_campaign=org_readme)**: MLOps/LLMOps platform for model serving and monitoring.
-### ☁️ Instill Cloud
-Not quite into self-hosting? We've got you covered with **☁️ [Instill Cloud](https://instill.tech/?utm_source=github&utm_medium=readme&utm_campaign=instill-core)**. It's a fully managed public cloud service, providing you with access to all the features of **🔮 Instill Core** without the burden of infrastructure management. All you need to do is to one-click sign up to start building your AI-first applications.
+## What can you build?
-## Prerequisites
+- 📖 Parsing PDF Files to Markdown: [Cookbook](https://github.com/instill-ai/cookbook/blob/main/examples/Parsing_pdf_files.ipynb)
+- 🧱 Generating Structured Outputs from LLMs: [Cookbook](https://github.com/instill-ai/cookbook/blob/main/examples/Generating_structured_outputs.ipynb) & [Tutorial](https://www.instill.tech/blog/llm-structured-outputs)
+- 🕸️ Web scraping & Google Search with Structured Insights: [Tutorial](https://www.instill.tech/blog/mastering-openai-structured-outputs) & [YouTube](https://www.youtube.com/watch?v=x0XsmuCrit8)
+- 🌱 Instance segmentation on microscopic plant stomata images: [Cookbook](https://github.com/instill-ai/cookbook/blob/main/examples/Instance_segmentation_stomavision.ipynb)
-- **macOS or Linux** - **🔮 Instill Core** works on macOS or Linux
+See [Examples](https://www.instill.tech/docs/examples) for more!
-- **Windows** - **🔮 Instill Core** works on Windows through Windows Linux Subsystem (WSL2)
- - Install the lastest version of `yq` from the GitHub [Repository](https://github.com/mikefarah/yq), as the package `yq` is not installed on Ubuntu WSL2 by default
+## Installation
- - Install the latest version of Docker Desktop on Windows and enable the WSL2 integration following the [tutorial](https://docs.docker.com/desktop/wsl) by Docker
+### Prerequisites
- - (optional) Install `cuda-toolkit` on WSL2 following the [tutorial](https://docs.nvidia.com/cuda/wsl-user-guide/index.html#getting-started-with-cuda-on-wsl-2) by NVIDIA
+| Operating System | Requirements and Instructions |
+|------------------|--------------------------------|
+| macOS or Linux | Instill Core works natively |
+| Windows | • Use Windows Subsystem for Linux (WSL2) • Install latest `yq` from [GitHub Repository](https://github.com/mikefarah/yq) • Install latest Docker Desktop and enable WSL2 integration ([tutorial](https://docs.docker.com/desktop/wsl)) • (Optional) Install `cuda-toolkit` on WSL2 ([NVIDIA tutorial](https://docs.nvidia.com/cuda/wsl-user-guide/index.html#getting-started-with-cuda-on-wsl-2)) |
+| All Systems | • Docker Engine v25 or later • Docker Compose v2 or later • Install latest stable [Docker](https://docs.docker.com/get-docker/) and [Docker Compose](https://docs.docker.com/compose/install/) |
-- **Docker and Docker Compose** - **🔮 Instill Core** requires Docker Engine `v25` or later and Docker Compose `v2` or later to run all services locally. Please install the latest stable [Docker](https://docs.docker.com/get-docker/) and [Docker Compose](https://docs.docker.com/compose/install/).
-## Quick Start
+### Steps
**Use stable release version**
@@ -107,9 +99,21 @@ $ make down
Explore the [documentation](https://www.instill.tech/docs/latest/core/deployment) to discover all available deployment options.
+## Deployment
+
+You can either self-host **🔮 Instill Core** or choose our fully managed **☁️ Instill Cloud** to get access to all the latest features. Visit the [Deployment Overview](https://www.instill.tech/docs/core/deployment) for more details.
+
+
+
+
+
+
+
+
+
+
## Client Access
-To access **🔮 Instill Core** and **☁️ Instill Cloud**, you have a few options:
- 📺 Instill Console
- ⌨️ Instill CLI
- 📦 Instill SDK:
@@ -119,43 +123,38 @@ To access **🔮 Instill Core** and **☁️ Instill Cloud**, you have a few opt
## Documentation
- For comprehensive guidance and resources, explore our [documentation website](https://www.instill.tech/docs?utm_source=github&utm_medium=link&utm_campaign=instill-core) and delve into our [API reference](https://openapi.instill.tech).
-
-## Contributing
-
-We welcome contributions from the community! Whether you're a developer, designer, writer, or user, there are multiple ways to contribute:
-
-### Issue Guidelines
+Please visit our [official documentation](https://www.instill.tech/docs?utm_source=github&utm_medium=link&utm_campaign=instill-core) for more.
-We foster a friendly and inclusive environment for issue reporting. Before creating an issue, check if it already exists. Use clear language and provide reproducible steps for bugs. Accurately tag the issue (bug, improvement, question, etc.).
+Additional resources:
-### Code Contributions
+- [API Reference](https://openapi.instill.tech)
+- [Cookbooks](https://github.com/instill-ai/cookbook)
+- [Tutorials](https://www.instill.tech/blog)
+- [Examples](https://www.instill.tech/docs/examples)
-Please refer to the [Contributing Guidelines](./.github/CONTRIBUTING.md) for more details. Your code-driven innovations are more than welcome!
+## Contributing
-## Community
+We welcome contributions from our community! Checkout the methods below:
-We are committed to providing a respectful and welcoming atmosphere for all contributors. Please review our [Code of Conduct](https://github.com/instill-ai/.github/blob/main/.github/CODE_OF_CONDUCT.md) to understand our standards.
+1. **Cookbooks**: Help us create helpful pipelines and guides for the community. Visit our [Cookbook repository](https://github.com/instill-ai/cookbook) to get started.
-### Efficient Triage Process
+2. **Issues**: Contribute to improvements by raising tickets using [templates here](https://github.com/instill-ai/instill-core/issues/new/choose) or discuss in existing ones you think you can help with.
-We have implemented a streamlined [Issues Triage Process](.github/triage.md) aimed at swiftly categorizing new issues and pull requests (PRs), allowing us to take prompt and appropriate actions.
+### Community Standards
-### Engage in Dynamic Discussions and Seek Support
+We are committed to maintaining a respectful and welcoming atmosphere for all contributors. Before contributing, please read:
-Head over to our [Discussions](https://github.com/orgs/instill-ai/discussions) for engaging conversations:
+- [Contributing Guidelines](./.github/CONTRIBUTING.md)
+- [Code of Conduct](https://github.com/instill-ai/.github/blob/main/.github/CODE_OF_CONDUCT.md)
-- [General](https://github.com/orgs/instill-ai/discussions/categories/general): Chat about anything related to our projects.
-- [Polls](https://github.com/orgs/instill-ai/discussions/categories/polls): Participate in community polls.
-- [Q&A](https://github.com/orgs/instill-ai/discussions/categories/q-a): Seek help or ask questions; our community members and maintainers are here to assist.
-- [Show and Tell](https://github.com/orgs/instill-ai/discussions/categories/show-and-tell): Showcase projects you've created using our tools.
+### Support
-Alternatively, you can also join our vibrant [Discord](https://discord.gg/sevxWsqpGh) community and direct your queries to the #ask-for-help channel. We're dedicated to supporting you every step of the way.
+Get help by joining our [Discord community](https://discord.gg/sevxWsqpGh) where you can post any questions on our `#ask-for-help` channel.
## Contributors ✨
-Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
+Thank you to all these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
@@ -204,6 +203,30 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
- 
