Skip to content

Latest commit

 

History

History
220 lines (154 loc) · 19.2 KB

README.md

File metadata and controls

220 lines (154 loc) · 19.2 KB

instill-core

Integration Test GitHub release (latest SemVer including pre-releases) Artifact Hub Discord All Contributors

Explore 🔮 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 repository. Please consult the documentation for more details.

🔮 Instill Core - The full-stack AI infrastructure tool

💧 Instill VDP - Pipeline orchestration for unstructured data ETL

💧 Instill VDP, also known as VDP (Versatile Data Pipeline), serves as a powerful pipeline orchestration tool tailored to address unstructured data ETL challenges.


⚙️ Instill Component is an extensible integration framework that enhances 💧 Instill VDP, unlocking limitless possibilities. Please visit the component package for details.

⚗️ Instill Model - Model orchestration for MLOps/LLMOps

⚗️ 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 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.

☁️ Instill Cloud

Not quite into self-hosting? We've got you covered with ☁️ Instill Cloud. 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.

Prerequisites

  • macOS or Linux - 🔮 Instill Core works on macOS or Linux

  • Windows - 🔮 Instill Core works on Windows through Windows Linux Subsystem (WSL2)

    • Install the lastest version of yq from the GitHub Repository, as the package yq is not installed on Ubuntu WSL2 by default

    • Install the latest version of Docker Desktop on Windows and enable the WSL2 integration following the tutorial by Docker

    • (optional) Install cuda-toolkit on WSL2 following the tutorial by NVIDIA

  • 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 and Docker Compose.

Quick Start

Use stable release version

Execute the following commands to pull pre-built images with all the dependencies to launch:

$ git clone -b v0.44.1-beta https://github.com/instill-ai/instill-core.git && cd instill-core

# Launch all services
$ make all

Note

We have restructured our project repositories. If you need to access 🔮 Instill Core projects up to version v0.13.0-beta, please refer to the instill-ai/deprecated-core repository.

Use the latest version for local development

Execute the following commands to build images with all the dependencies to launch:

$ git clone https://github.com/instill-ai/instill-core.git && cd instill-core

# Launch all services
$ make latest PROFILE=all

Important

Code in the main branch tracks under-development progress towards the next release and may not work as expected. If you are looking for a stable alpha version, please use latest release.

🚀 That's it! Once all the services are up with health status, the UI is ready to go at http://localhost:3000. Please find the default login credentials in the documentation.

To shut down all running services:

$ make down

Explore the documentation to discover all available deployment options.

Client Access

To access 🔮 Instill Core and ☁️ Instill Cloud, you have a few options:

Documentation

For comprehensive guidance and resources, explore our documentation website and delve into our API reference.

Contributing

We welcome contributions from the community! Whether you're a developer, designer, writer, or user, there are multiple ways to contribute:

Issue Guidelines

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.).

Code Contributions

Please refer to the Contributing Guidelines for more details. Your code-driven innovations are more than welcome!

Community

We are committed to providing a respectful and welcoming atmosphere for all contributors. Please review our Code of Conduct to understand our standards.

Efficient Triage Process

We have implemented a streamlined Issues Triage Process aimed at swiftly categorizing new issues and pull requests (PRs), allowing us to take prompt and appropriate actions.

Engage in Dynamic Discussions and Seek Support

Head over to our Discussions for engaging conversations:

  • General: Chat about anything related to our projects.
  • Polls: Participate in community polls.
  • Q&A: Seek help or ask questions; our community members and maintainers are here to assist.
  • Show and Tell: Showcase projects you've created using our tools.

Alternatively, you can also join our vibrant Discord community and direct your queries to the #ask-for-help channel. We're dedicated to supporting you every step of the way.

Contributors ✨

Thanks goes to these wonderful people (emoji key):


Vibhor Bhatt

Miguel Ortiz

Sajda Kabir

Henry Chen

Hari Bhandari

Shiva Gaire

Zubeen

ShihChun-H

Ikko Eltociear Ashimine

Farookh Zaheer Siddiqui

Brian Gallagher

hairyputtar

David Marx

Deniz Parlak

Po-Yu Chen

Po Chun Chiu

Sarthak

HR Wu

phelan

Chang, Hui-Tang

Xiaofei Du

Ping-Lin Chang

Tony Wang

Pratik date

Juan Vallés

Naman Anand

totuslink

Praharsh Jain

Utsav Paul

CaCaBlocker

Rafael Melo

This project follows the all-contributors specification. Contributions of any kind welcome!

License

See the LICENSE file for licensing information.