Skip to content

README.md

Latest commit

 

History

History
332 lines (247 loc) · 10.9 KB

README.md

File metadata and controls

332 lines (247 loc) · 10.9 KB
Raw

AI Tools Collection - Open Source

🌟 Stars 🍴 Forks 🐛 Issues 🔔 Open PRs 🔕 Closed PRs 🛠️ Languages 👥 Contributors
Stars Forks Issues Open PRs Closed PRs Languages Count Contributors Count

🎁 AI Tools Collection - Open Source

A curated collection of powerful AI tools, maintained by the community. This project welcomes contributions from developers worldwide to help build the most comprehensive AI tools directory.

🌟 Features

  • Curated AI Tools: Hand-picked collection of the best free AI tools
  • Community Driven: Open for contributions from anyone
  • Responsive Design: Works perfectly on all devices
  • Easy Navigation: Organized by categories for quick discovery
  • Search & Filter: Find tools quickly with built-in search functionality
  • Analytics Tracking: Usage insights with Google Analytics

🎯 Project Goals

  • To create the most comprehensive and high-quality directory of free AI tools.
  • To provide a platform for developers, designers, and creators to discover the best AI tools for their work.
  • To foster a community of contributors who are passionate about AI and open source.

🚀 Live Demo

Visit the live website: AI Tools Collection

📊 Current Stats

  • 100+ Free AI Tools
  • 10 Categories
  • Open Source & Community Maintained
  • 15+ Active Contributors

🤝 How to Contribute

We welcome contributions from everyone! Here's how you can help improve this project:

Adding New AI Tools

  1. Fork this repository

  2. Clone your fork locally

    git clone https://github.com/YOUR_USERNAME/ai-tools-manager.git
cd ai-tools-manager

  3. Add your tool to data/links.json

    • Find the appropriate category or create a new one
    • Add your tool following this format:
    {
  "title": "Tool Name",
  "url": "https://tool-website.com",
  "description": "Brief description of what the tool does"
}

  4. Add yourself as a contributor (see below)

  5. Test your changes

    • Open index.html in your browser
    • Verify your tool appears correctly
    • Check that the link works

  6. Submit a Pull Request

    • Create a descriptive title
    • Explain what tool you added and why it's valuable
    • Include any relevant screenshots

Adding Yourself as a Contributor

When you contribute, add yourself to the contributors list:

  1. Add your information to data/contributors.json:

    {
  "name": "Your Name",
  "github": "your-github-username",
  "avatar": "https://github.com/your-username.png",
  "contributions": ["Added Tool Name", "Fixed bug in category X"],
  "website": "https://your-website.com" // optional
}

  2. Your profile will automatically appear in the contributors section

📁 Project Structure

ai-tools-collection/
├── index.html              # Main HTML file
├── style.css               # Styling and animations
├── script.js               # JavaScript functionality
├── manifest.json           # PWA manifest
├── package.json            # Project configuration
├── README.md               # This file
├── data/                   # Data files
│   ├── links.json          # AI tools database
│   └── contributors.json   # Contributors database
├── docs/                   # Documentation
│   ├── CONTRIBUTING.md     # Contribution guidelines
│   ├── COMMIT_GUIDELINES.md # Commit message standards
│   └── CONTRIBUTOR_EXAMPLE.md # Contributor profile template
├── scripts/                # Validation scripts
│   ├── validate-links.js   # Links validation
│   └── validate-contributors.js # Contributors validation
├── assets/                 # Project assets
│   ├── favicon.svg         # Site favicon
│   ├── og-image.svg        # Social media image
│   └── README.md           # Assets documentation
└── .github/                # GitHub configuration
    ├── workflows/          # CI/CD workflows
    ├── ISSUE_TEMPLATE/     # Issue templates
    └── hooks/              # Git hooks

🛠️ Development Setup

  1. Clone the repository

    git clone https://github.com/ArshdeepGrover/ai-tools-collection.git
cd ai-tools-collection

  2. Install dependencies (optional)

    npm install

  3. Run validation scripts

    # Check for duplicate tools
npm run check-duplicates

# Validate all links and data
npm run validate

# Validate contributors data
npm run validate-contributors

  4. Open in your browser

    # Simply open index.html in your preferred browser
# Or use a local development server:

# Using Node.js (if installed):
npx serve .

# Using PHP (if installed):
php -S localhost:8000

# Or just double-click index.html to open in browser

  5. Make your changes

    • Edit data/links.json to add/modify tools
    • Update data/contributors.json to add yourself
    • Modify CSS/JS as needed

🔧 Validation & Quality Assurance

This project includes automated validation to maintain high quality:

Automated Checks

# Check for duplicate tools across categories
npm run check-duplicates

# Validate all links and data structure
npm run validate

What Gets Validated

  • Link Accessibility: All tool URLs are checked for availability
  • Data Structure: JSON files are validated for proper format
  • Duplicate Detection: Prevents adding tools that already exist
  • Contributor Profiles: Ensures all contributor data is complete
  • Category Consistency: Verifies proper categorization

📋 Contribution Guidelines

For AI Tools

  • Free or Freemium: Tools should have a free tier or be completely free
  • Working Links: Ensure all URLs are active and correct
  • Accurate Descriptions: Provide clear, concise descriptions (max 60 characters)
  • Appropriate Category: Place tools in the right category
  • No Duplicates: Check if the tool already exists using validation scripts

For Code Contributions

  • Clean Code: Follow existing code style and structure
  • Test Changes: Ensure your changes don't break existing functionality
  • Responsive Design: Maintain mobile-friendly design
  • Performance: Keep the site fast and lightweight

Current Categories

  • AI Writing & Content ✍️: Writing, editing, content creation tools
  • AI Design & Images 🎨: Image generation, design, visual content tools
  • AI Presentations 📊: Presentation creation and slide design tools
  • AI Coding & Development 💻: Code assistance and development tools
  • AI Video & Audio 🎬: Video editing, audio processing, multimedia tools
  • AI Productivity ⚡: Productivity, automation, and research tools
  • AI Entertainment 😂: Fun and entertainment AI tools
  • AI Model Prototyping 🧪: AI model development and testing tools
  • AI Game & Strategy 🎮: Gaming and strategic AI applications
  • AI Local Models 🖥️: Tools for running AI models locally

Creating New Categories

If you want to add a new category:

  1. Add to links.json:

    {
  "name": "New Category Name",
  "icon": "🔥", // Choose an appropriate emoji
  "links": [
    // Your tools here
  ]
}

  2. Ensure it fits the theme: Should be AI-related tools

🎨 Design Guidelines

  • Consistent Styling: Follow the existing design patterns
  • Accessibility: Ensure good contrast and keyboard navigation
  • Mobile First: Design should work on mobile devices
  • Performance: Optimize images and minimize code

📈 Analytics

This project uses Google Analytics to track:

  • Page views and user engagement
  • Popular tools and categories
  • Geographic distribution of users
  • Device and browser usage

Analytics help us understand how to improve the collection and what tools are most valuable to users.

🏆 Contributors

Thank you to all the amazing people who have contributed to this project!

📄 License

This project is open source and available under the MIT License.

🚀 Features & Roadmap

Current Features

  • ✅ 100+ curated AI tools across 10 categories
  • ✅ Real-time search and filtering
  • ✅ Responsive design for all devices
  • ✅ Progressive Web App (PWA) support
  • ✅ SEO optimized with social media integration
  • ✅ Community contributor system
  • ✅ Automated link validation
  • ✅ Duplicate detection system

Upcoming Features

  • 🔄 Advanced filtering by pricing tiers
  • 🔄 Tool rating and review system
  • 🔄 API for developers
  • 🔄 Mobile app versions
  • 🔄 Multi-language support
  • 🔄 Tool comparison features

🙏 Acknowledgments

  • Original Creator: Arshdeep Singh
  • All Contributors: Thank you to our 15+ contributors for making this project better!
  • AI Tool Creators: Thanks to all the amazing AI tool developers
  • Open Source Community: For the inspiration and support

📞 Contact & Support

⭐ If you find this project helpful, please give it a star on GitHub!

Made with ❤️ by the community