npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@brngdsn/vox

v0.2.3

Published

voice-operated execution

Downloads

11

Readme

VOX - Voice Operated eXecution

VOX Logo

VOX is a powerful Node.js CLI tool that allows you to execute commands using your voice. Leveraging the capabilities of OpenAI's Whisper for transcription and intelligent processing, VOX provides an interactive and efficient way to interact with your system through voice commands.

Table of Contents

Features

  • Voice Input: Record audio commands and transcribe them using OpenAI's Whisper model.
  • Interactive CLI: User-friendly interface with colored outputs and real-time feedback.
  • Directory Indexing: Summarizes the current directory structure, including file counts and sizes.
  • Environment Checks: Verifies the presence of essential environment variables and Git repository status.
  • Real-time Feedback: Visual indicators like spinners and decibel meters enhance user experience.
  • Automated Workspace Handling: Processes commands and opens relevant workspaces in your browser.

Prerequisites

  • Node.js: Ensure you have Node.js (v14 or later) installed on your machine. You can download it from Node.js Official Website.
  • Git: (Optional) For version control and repository management. Download from Git Official Website.

Installation

  1. Clone the Repository

    git clone https://github.com/your-username/vox.git
    cd vox
  2. Install Dependencies

    Navigate to the project directory and install the necessary dependencies using npm:

    npm install

OR

  1. NPM Install Globally

    npm install -g vox

Configuration

  1. Environment Variables

    VOX requires an OpenAI API key to function correctly. Create a .env file in the root directory of the project and add your OpenAI API key:

    OPENAI_API_KEY=your_openai_api_key_here

    Replace your_openai_api_key_here with your actual OpenAI API key. If you don't have one, you can obtain it from the OpenAI Dashboard.

Usage

Start the VOX CLI by running the following command:

node index.js

Upon starting, VOX will display an ASCII art logo, a summary of the current directory, Git repository status, and environment variable checks.

Available Commands

Once the CLI is running, you can interact with it using the following commands:

  • /voice

    Record audio input and save it to voice_input.wav. The audio will be transcribed using OpenAI's Whisper model, and the transcribed text will be processed for command execution.

    /voice
  • /help

    Display the help message with a list of available commands.

    /help
  • /exit

    Exit the VOX application.

    /exit

Contributing

Contributions are welcome! If you'd like to contribute to VOX, please follow these steps:

  1. Fork the Repository

    Click the "Fork" button at the top right of this page to create a copy of the repository under your GitHub account.

  2. Create a New Branch

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

    Implement your feature or bug fix.

  4. Commit Your Changes

    git commit -m "Add your message here"
  5. Push to Your Fork

    git push origin feature/YourFeatureName
  6. Create a Pull Request

    Navigate to the original repository and click "Compare & pull request" to submit your changes for review.

License

This project is licensed under the MIT License.


Developed with ❤️ by the VOX Team

License

MIT License. See the LICENSE file for details.

Acknowledgements

  • OpenAI for providing the Whisper transcription model.
  • Node.js for the robust JavaScript runtime.
  • Ora for the elegant terminal spinner.
  • Numeral.js for number formatting.

Support

If you encounter any issues or have questions, feel free to open an issue on the repository.

Contact

For any inquiries or feedback, please reach out to [email protected].


© 2024 VOX. All rights reserved.