Skip to content

developmentation/whizbang

Repository files navigation

AI Starter Template

AI Starter Template provides a modern Vue/Node integrated template to allow for rapid building and deployment using AI-enabled IDEs (Cursor, etc.) or leveraging key files with web interface chat protocols to rapidly build out and deploy fully functional apps for testing and evaluation This is a template to kickstart your journey! Fork it, build your app, and make it your own with a feature branch or a full fork.

Major Features

Whatever you decide


Installation

Prerequisites

  • Node.js: v20 or later recommended
  • npm: v9+ (or yarn if preferred)
  • Git: For cloning the repository
  • Optional: nodemon for development server auto-restart

Setup Steps

  1. Clone the Repository

    git clone https://github.com/developmentation/ai-starter-template.git
    cd ai-starter-template
  2. Install Dependencies Using npm:

    npm install
  3. Configure Environment

    • Copy the example .env file and add your API keys (e.g., LLM providers):
      cp .env.example .env
    • Edit .env with your keys, e.g.:
      OPENAI_API_KEY=your_openai_key
      PORT=3000
      
  4. Start the Development Server

    • Install nodemon globally (if not already installed):
      npm install -g nodemon
      Or as a dev dependency:
      npm install --save-dev nodemon
    • Launch the server:
      nodemon index.js
  5. Access the Application

    • Open your browser to http://localhost:3000 (or the port specified in .env).

Usage

Provide users instructions on how to use this


Technologies Used

  • Vue.js 3.5: Reactive frontend with Composition API for scalable logic.
  • Socket.IO: WebSocket-driven real-time communication.
  • Tailwind CSS: Utility-first styling for a modern, responsive UI.
  • Node.js: Server-side runtime.
  • MongoDB: Backend data storage (optional, depending on fork).
  • Mongoose: Backend document schemas and simplified Database interactions.
  • LLM Providers: OpenAI, Anthropic, xAI, etc., for AI outputs.

Contributing

Join the revolution! This template thrives on community input—report bugs, suggest features, or submit code to make it even better.

  1. Fork the Repository

    • Click "Fork" on GitHub to create your copy.
  2. Create a Feature Branch

    git checkout -b feature/YourFeatureName
  3. Commit Your Changes

    git commit -m "Add your feature description"
  4. Push to Your Branch

    git push origin feature/YourFeatureName
  5. Open a Pull Request

    • Go to your forked repo on GitHub and click "New Pull Request" to submit your changes.

Ensure your code follows the project’s style guide (e.g., ESLint, Prettier) and passes tests before submitting.


License

Licensed under the MIT License—free to use, modify, and share.

About

A super demo app

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published