Skip to main content

Installation Guide

This guide will help you set up Medispeak in your preferred environment.

Chrome Extension (Developer Mode)​

  1. Clone the repository:

    git clone https://github.com/medispeak/extension.git
    cd extension

  2. Install dependencies:

    npm install

  3. Build the extension:

    npm run build

  4. Load in Chrome:

    • Open Chrome and go to chrome://extensions/
    • Enable "Developer mode" in the top right
    • Click "Load unpacked"
    • Select the build directory from the extension folder

WebApp Integration​

Using Script Tag​

  1. Add Script to HTML

    <script src="https://cdn.medispeak.io/widget.js"></script>

  2. Initialize Widget

    <div id="medispeak-container"></div>
    <script>
      Medispeak.init({
        container: 'medispeak-container',
        apiKey: 'your-api-key',
        emrSystem: 'care', // or 'bahmni' for Bahmni EMR
        emrConfig: {
          // Optional custom configuration for other web-based EMRs
          baseUrl: 'your-emr-base-url',
          fieldMappings: {
            // Custom field mappings
          }
        }
      });
    </script>

EMR Configuration​

You can configure Medispeak to work with any web-based EMR by:

  1. Access Medispeak Admin interface
  2. Configure EMR connection details
  3. Set up field mappings
  4. Test the integration
  5. Deploy configuration

Supported EMRs​

CARE (Open Healthcare Network)​

Bahmni EMR​

Feel free to reach out to us to get access to the EMR configurations.

Configuration Options​

Widget Options​

  • Theme customization
  • Voice recognition settings
  • EMR integration settings
  • UI customization

Extension Options​

  • Voice recognition sensitivity
  • EMR field mapping
  • Keyboard shortcuts
  • Privacy settings

Troubleshooting​

Common Issues​

  1. Voice Recognition Not Working

    • Check microphone permissions
    • Verify browser compatibility
    • Test microphone input levels

  2. EMR Integration Issues

    • Verify API credentials
    • Check network connectivity
    • Validate field mappings
    • Ensure EMR system is supported or properly configured

  3. Performance Issues

    • Clear browser cache
    • Check system resources
    • Verify network speed

Getting Help​

If you encounter issues:

  1. Check our FAQ
  2. Visit GitHub Issues
  3. Join our Community Discussion

Security Considerations​

  • Keep API keys secure
  • Regularly update dependencies
  • Monitor system logs
  • Enable appropriate security headers

Next Steps​

After installation:

  1. Complete the Getting Started guide
  2. Review Best Practices
  3. Explore our Projects