repository·main·Indexed 43 days ago
https://github.com/supercorp-ai/superinterfaceAn AI assistants library that enables developers to integrate AI capabilities into web applications using React components and hooks. It is optimized for building AI-first user interfaces such as chats, wizards, and audio threads.
To run the audio-thread-dialog-realtime example locally, navigate to the example directory and use your preferred package manager to start the development server. Once running, you can view the live application in your browser at http://localhost:3000.
To begin customizing the application, modify the app/page.tsx file. The development server supports hot-reloading, so the page will auto-update as you save changes.
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun devAfter building the project, you can deploy Superinterface by including one of the specific global JavaScript bundles in your HTML file, depending on the desired interaction mode:
Thread.global.js.ThreadDialog.global.js.AudioThread.global.js.To customize the rendering target for an inline Thread (which defaults to a div with id="thread-root"), you must edit the Thread.tsx file and run npm run build again.
app/page.tsx. Modifying this file will trigger an auto-update in your browser via the development server.To run the thread-dialog-script-tag example in a development environment, use your preferred package manager to start the development server. Once running, you can view the application at http://localhost:3000. To make changes to the UI, edit the app/page.tsx file; the page will automatically update in your browser.
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun devapp/page.tsx. Changes made to this file will trigger automatic updates in the browser via Next.js Fast Refresh.To run the audio-thread example project, navigate to the example directory and use your preferred package manager to start the development server. Once running, you can view the application in your browser at http://localhost:3000.
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun devTo run the local development server for the primitives example, navigate to the examples/primitives directory and use your preferred package manager to execute the dev script. Once running, you can view the live application at http://localhost:3000.
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun devaudio-thread example is located at app/page.tsx. Modifying this file will trigger an auto-update in the browser during development.To run the Superinterface form filling example in a development environment, navigate to the example directory and use your preferred package manager to start the development server. Once running, the application will be available at http://localhost:3000.
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun devTo build and publish the production server as a Docker image, run the following commands from the repository root. The server-release bake target will automatically tag the image with both the specific version provided and the latest tag.
Ensure you replace <version> with the specific npm version you are releasing (e.g., 1.1.7).
npm install
TAG=<version> docker buildx bake server-release
docker push supercorp/superinterface-server:<version>
docker push supercorp/superinterface-server:latestTo run the local development server for the components example, navigate to the example directory and use your preferred package manager to execute the dev script. Once running, you can view the live application at http://localhost:3000.
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev