InningIQ - AI-Powered Baseball Analysis Assistant (formerly jyBaseball)

Important Update: The jyBaseball project described in this README is now outdated. The project has been renamed and upgraded to the InningiQ initiative. InningiQ is a more comprehensive AI-driven baseball analysis platform that incorporates the core functionalities of jyBaseball while adding new features. Please refer to the latest InningiQ documentation for current features and usage instructions.

The following is the description of the original jyBaseball project, provided for reference only:

重要更新: 本 README 所描述的 jyBaseball 項目已經過時。此專案已更名並升級為 InningiQ 計劃。 InningiQ 是一個更全面的 AI 驅動的棒球分析平台，融合了 jyBaseball 的核心功能並添加了新的功能。請參考最新的 InningiQ 文件以取得目前功能和使用說明。

以下是原 jyBaseball 項目的描述，僅供參考：

jyBaseball - Baseball Data Digitization and Analysis Platform

jyBaseball(棒球紀錄趣) is a platform designed to digitize traditional paper-based baseball records and provide advanced data analysis tools. Our goal is to support both professional and amateur baseball teams by offering intuitive tools for recording, storing, and analyzing game data. One of our key features is K-Zone batting average analysis, but we place equal emphasis on making baseball data more accessible and actionable by moving away from paper-based systems.

Click on the picture to view our full presentation PDF

Current Status and Limitations

Important Note: jyBaseball is currently in a prototype stage. The full functionality, including the generation of hitting zone charts, is only available when the backend is running on the developer's local machine. We are actively working on deploying a stable backend solution to make all features accessible online.

Key Features

1. Paper-based Data Digitization

   • Convert traditional paper-based baseball records into digital form
   • Secure and centralized data storage using Google Sheets for easy access and management

2. Data Input and Storage

   • User-friendly interface for inputting detailed game statistics
   • Centralized storage of game data to support long-term tracking and analysis

3. Advanced Statistical Analysis

   • Comprehensive calculations based on input data
   • Generation of various statistical insights, including K-Zone batting average analysis

4. Visual Representation of Data

   • Visual representation of hitting patterns and weaknesses
   • Generation of hitting zone charts and other statistical graphs
   • Note: Full visualization features are currently available only when the backend is running locally, but history records can still be viewed

5. Cross-platform Compatibility

   • Web-based design accessible from any device
   • Responsive interface for desktop and mobile use

6. Real-time Data Processing (When backend is active)

   • Instant data analysis and visualization
   • Quick insights for coaches and analysts

Technology Stack

• Frontend: HTML5, CSS3, JavaScript (HTML5 UP template)
• Backend: Python for data processing and visualization
• Database: Google Sheets for data storage
• APIs: Google API for data interaction

Getting Started

To use the current version:

1. Visit jyBaseball
2. Input detailed game data
3. View stored data on the website

Please note that while data input and storage are always available, the generation of visual representations (like hitting zone charts) is only accessible when the backend is actively running on the developer's local machine.

Future Development Plans

1. Backend Deployment: Our top priority is to deploy a stable, always-on backend service to enable full functionality for all users at any time.

2. Enhanced Data Visualization: Expand our range of visual representations and statistical analyses.

3. Real-time Integration: Develop capabilities for instant data analysis and visualization during live games.

4. CPBL Integration: Explore possibilities of integrating with CPBL's official statistical systems.

5. Mobile App Development: Create a dedicated mobile app for on-the-go analysis.

Contributing

We welcome contributions from the community! If you're interested in improving jyBaseball, please check our Contributing Guidelines (coming soon) for more information.

License

This project is for educational and non-commercial use only. All data and analysis results are for reference purposes. For licensing inquiries, please contact: [email protected]

The Team

jyBaseball is developed with passion by:

• 游松澤 (Yu Song-Ze)
• 張昀棠 (Zhang Yun-Tang)
• 張羿軒 (Zhang Yi-Xuan)

Project Team: vaclis.

Contact

For collaboration, bug reports, or any inquiries, please reach out to us:

• @vaclisinc
• @WavJaby
• @Andrewtangtang

---

Developed with ❤️ by the vaclis. team