ALPHA (Awesome Logical Processing Holistic Assistance) is a local voice assistant project with:

• A React frontend UI
• An Express backend endpoint
• A Python voice assistant runner (jarvis.py)

• React 18 + React Router
• Tailwind CSS
• Express.js
• Python-based assistant logic (speech recognition + API integrations)

Before running locally, make sure you have:

• Node.js 18+ and npm
• Python 3.9+ available as python in your PATH
• A working microphone
• Python dependencies used by src/components/jarvis.py (for example: speech_recognition, pyaudio, ffmpeg-python, requests, wolframalpha, elevenlabs, and g4f)

Note: the Python script currently includes a hardcoded API key and external service usage. For production or sharing, move secrets to environment variables and rotate exposed keys.

1. Install JavaScript dependencies:

npm install

2. Start the app and backend together:

npm start

3. Open:

• Frontend: http://localhost:3000
• Backend health check: http://localhost:3001

The frontend sends POST /run-jarvis requests to the Express server, which spawns the Python assistant process.

• npm start: Starts React dev server and Express backend concurrently.
• npm run server: Starts only the Express backend on port 3001.
• npm test: Runs React tests.
• npm run build: Builds the frontend for production.
• npm run eject: Ejects Create React App config (irreversible).

src/
	App.js
	AllRoutes.js
	components/
		Home.js
		Layout.js
		Header.js
		server.js
		jarvis.py
		ui/
		utils/

• / -> Home screen (src/AllRoutes.js)

• The repository includes FFmpeg documentation and presets under src/components/doc/ and src/components/presets/.
• On Windows, audio/FFmpeg-related Python dependencies may require additional setup depending on your Python installation.