Home / InsightPoint / InsightPoint Specification
InsightPoint
The Point of Understanding Pain.
Overview
InsightPoint is an open-source, AI-powered pain tracking and body-awareness platform that combines Eastern and Western medicine, anatomical mapping, traditional pressure-point systems, symptom analysis, and symbolic self-reflection. Its purpose is to help individuals explore the relationships between physical discomfort, anatomical structures, traditional energetic pathways, lifestyle patterns, and personal well-being.
The platform uses artificial intelligence to analyze reported symptoms, identify recurring pain patterns, map anatomical locations to corresponding Eastern medicine pressure points and meridians, and provide educational insights into potential contributing factors. Users can explore multiple perspectives on their physical experiences while maintaining a distinction between established medical knowledge, traditional healing concepts, and symbolic interpretations.
InsightPoint extends beyond conventional symptom tracking by incorporating guided self-evaluation and reflective exercises. It encourages users to consider whether recurring physical discomfort coincides with stress, lifestyle circumstances, emotional experiences, personal responsibilities, or other factors that may warrant attention. Symbolic interpretations are presented as optional cultural and reflective perspectives rather than medical explanations or established causes of pain.
The platform is designed around privacy, user ownership of personal information, modular functionality, and extensibility. Its architecture supports independent core modules and optional plugins, allowing additional medical references, traditional medicine systems, AI capabilities, wearable integrations, and practitioner collaboration to be incorporated without compromising the primary application.
Core Modules
Pain Mapping and Body Visualization
- Provide interactive anatomical body diagrams with front, back, and selectable regional views.
- Allow users to identify precise locations of physical discomfort.
- Support identification of muscles, bones, joints, nerves, tendons, ligaments, and connective tissues.
- Allow multiple pain locations to be recorded simultaneously.
- Distinguish localized, radiating, referred, and spreading pain.
- Provide visual representations of pain intensity and distribution.
- Generate interactive body heatmaps based on recorded symptoms.
- Track bilateral pain and relationships between different anatomical regions.
- Identify changes in pain location over time.
- Support two-dimensional and extensible three-dimensional anatomical visualization.
- Allow users to annotate specific locations with personal observations.
Pain Tracking and Symptom History
- Provide daily pain and symptom logging.
- Record pain intensity using configurable numerical scales.
- Classify pain as sharp, dull, aching, burning, stabbing, throbbing, tingling, pressure, or other user-defined sensations.
- Track symptom onset, duration, frequency, and progression.
- Record stiffness, swelling, numbness, restricted movement, and associated symptoms.
- Document potential triggers and contributing activities.
- Track posture, physical activity, sleep quality, hydration, nutrition, and stress.
- Record medications, treatments, therapies, and wellness interventions.
- Compare symptoms across days, weeks, months, and years.
- Identify recurring symptoms and changes in severity.
- Maintain a searchable chronological symptom history.
- Generate summaries of individual pain episodes and long-term patterns.
Western Medicine and Anatomical References
- Provide educational references covering human anatomy and physiology.
- Map pain locations to relevant anatomical structures.
- Include muscular, skeletal, neurological, joint, and connective tissue references.
- Identify relevant peripheral and central nervous system pathways.
- Explain nerve pathways and referred pain relationships.
- Include musculoskeletal and neurological condition references.
- Provide information about inflammatory processes and common pain mechanisms.
- Explain potential anatomical contributors to reported discomfort.
- Incorporate recognized medical classifications and reputable clinical information sources.
- Provide accessible explanations of medical terminology.
- Include references and source attribution for medical information.
- Distinguish possible explanations from confirmed diagnoses.
- Identify symptoms and combinations of symptoms that may require professional evaluation.
Eastern Medicine and Meridian Mapping
- Incorporate Traditional Chinese Medicine (TCM) reference systems.
- Map the twelve primary meridians and associated pathways.
- Identify recognized acupuncture and acupressure points.
- Associate selected body regions with nearby and traditionally related pressure points.
- Include traditional Yin and Yang concepts.
- Incorporate Five Element theory and traditional organ-system associations.
- Explain traditional concepts of Qi and energetic balance.
- Provide educational descriptions of meridian pathways and pressure-point locations.
- Incorporate traditional Ayurvedic body concepts and references.
- Include chakra mapping and associated traditional interpretations.
- Support comparisons between different Eastern medicine traditions.
- Clearly identify traditional concepts as distinct from established anatomical and physiological findings.
Cross-System Correlation
- Connect Western anatomical structures with corresponding Eastern medicine references.
- Map muscles, nerves, joints, and other anatomical structures alongside meridians and pressure points.
- Identify overlapping anatomical and traditional energetic locations.
- Explore relationships between reported pain locations and nearby acupressure points.
- Provide side-by-side comparisons of Western and Eastern medicine perspectives.
- Identify multiple traditional interpretations associated with a selected body region.
- Display relevant anatomical and traditional reference information together.
- Distinguish direct anatomical relationships from traditional energetic associations.
- Provide source references and confidence indicators.
- Allow users to explore different interpretations without presenting them as equivalent forms of medical evidence.
AI Pain Pattern Recognition
- Analyze historical symptom entries to identify recurring pain patterns.
- Recognize changes in pain location, intensity, frequency, and duration.
- Identify potential relationships between physical activity, posture, sleep, stress, and reported discomfort.
- Recognize recurring combinations of symptoms.
- Explore relationships between multiple pain locations.
- Identify patterns that may not be immediately apparent to the user.
- Generate personalized summaries of symptom history.
- Identify possible triggers and contributing circumstances.
- Compare reported symptoms before and after treatments or lifestyle changes.
- Provide AI-generated observations and questions for further investigation.
- Distinguish correlation from causation.
- Communicate uncertainty and limitations.
- Maintain historical records of AI-generated observations for comparison over time.
Symbolic Interpretation and Self-Evaluation
- Explore traditional symbolic associations between different body regions and personal experiences.
- Provide optional interpretations associated with recurring aches, tension, and physical discomfort.
- Incorporate symbolic themes involving responsibility, emotional burdens, personal boundaries, stability, security, flexibility, and life direction.
- Explore cultural and philosophical interpretations of mind-body relationships.
- Provide reflective questions based on selected pain locations and recurring patterns.
- Encourage examination of lifestyle circumstances, personal responsibilities, relationships, and stressors.
- Offer guided journaling exercises and self-evaluation activities.
- Allow users to document their own interpretations and experiences.
- Compare personal reflections with historical symptom patterns.
- Provide optional meditation and mindfulness prompts.
- Distinguish symbolic interpretations from medical explanations.
- Avoid assigning emotional or psychological causes to physical symptoms without supporting evidence.
- Allow users to disable symbolic interpretation features entirely.
AI Self-Reflection and Personal Insight
- Generate personalized self-evaluation questions based on user-selected topics.
- Explore possible relationships between stress and physical discomfort.
- Encourage reflection on workload, responsibilities, boundaries, and personal well-being.
- Identify recurring themes in optional journal entries.
- Track changes in self-reported emotional and physical experiences.
- Provide guided reflection exercises.
- Support mindfulness and body-awareness practices.
- Allow users to accept, reject, or modify AI-generated interpretations.
- Maintain separation between personal reflections and medical symptom records.
- Provide longitudinal personal insight summaries.
- Encourage users to seek qualified support when appropriate.
Acupressure and Holistic Wellness
- Provide an educational acupressure reference library.
- Display interactive pressure-point location guides.
- Explain traditional pressure-point associations.
- Provide educational instructions for appropriate self-care practices.
- Incorporate guided breathing and relaxation exercises.
- Provide meditation and mindfulness resources.
- Include gentle mobility and stretching references.
- Incorporate educational Qi Gong and traditional movement practices.
- Offer personalized educational resources based on recorded symptoms.
- Identify contraindications and safety considerations.
- Include warnings for areas and circumstances where pressure or manipulation may be inappropriate.
- Encourage consultation with qualified practitioners when necessary.
Western Wellness and Movement
- Provide educational stretching and mobility resources.
- Include posture and ergonomic awareness guidance.
- Offer muscle relaxation and movement education.
- Incorporate physical therapy educational references.
- Track physical activity and recovery.
- Provide movement suggestions based on user-selected limitations.
- Support exercise progression and response tracking.
- Identify activities that may aggravate reported symptoms.
- Include appropriate safety warnings.
- Encourage consultation with qualified healthcare professionals before beginning or modifying exercise programs when necessary.
Pain Correlation and Lifestyle Analytics
- Analyze relationships between pain reports and recorded lifestyle variables.
- Compare pain patterns with sleep quality, physical activity, stress, and other user-provided information.
- Identify recurring time-of-day and activity-related patterns.
- Track symptom changes following wellness activities or treatments.
- Visualize relationships between multiple symptoms.
- Generate customizable trend reports.
- Compare physical symptoms with optional self-reported emotional experiences.
- Identify changes in symptom frequency and severity.
- Provide longitudinal analytical summaries.
- Allow users to review and interpret their own data.
- Avoid presenting statistical associations as established medical causes.
Medical Safety and Escalation
- Identify potentially serious symptoms and medical warning signs.
- Provide clear guidance when symptoms may require emergency medical attention.
- Recognize symptom combinations that warrant prompt professional evaluation.
- Prioritize medical safety over traditional or symbolic interpretations.
- Provide appropriate warnings for potentially contraindicated activities and pressure-point techniques.
- Prevent AI-generated interpretations from overriding medical safety guidance.
- Clearly distinguish educational information from medical advice.
- Provide source attribution for medical safety information.
- Encourage consultation with qualified healthcare professionals.
- Avoid diagnosing medical conditions or recommending changes to prescribed treatment.
- Maintain safety guidance independently of optional wellness and symbolic modules.
Personal Journal and Wellness History
- Provide a private personal journal.
- Support symptom notes and personal observations.
- Allow optional emotional and lifestyle reflection entries.
- Provide daily wellness check-ins.
- Record treatments, exercises, and self-care activities.
- Support searchable historical entries.
- Display physical symptoms and personal reflections on separate but comparable timelines.
- Provide optional AI-assisted journal summaries.
- Allow users to control whether journal entries are included in AI analysis.
- Support user-defined categories and personal annotations.
Reporting and Data Export
- Generate comprehensive pain history reports.
- Provide anatomical pain distribution summaries.
- Generate pressure-point and meridian correlation reports.
- Display symptom frequency and intensity trends.
- Provide lifestyle and activity correlation summaries.
- Compare treatment and intervention responses.
- Generate optional personal reflection summaries.
- Support PDF and CSV exports.
- Provide healthcare-provider-friendly reports.
- Allow users to select which information is included in exported reports.
- Maintain clear distinctions between recorded symptoms, AI-generated observations, traditional references, and personal interpretations.
Privacy and Personal Data Management
- Prioritize local-first data storage.
- Maintain user ownership and control of personal information.
- Encrypt sensitive information at rest and in transit.
- Provide optional encrypted cloud synchronization.
- Allow users to configure AI data-sharing permissions.
- Require appropriate consent before processing sensitive journal or health information.
- Provide secure authentication and device management.
- Support data portability and user-directed deletion.
- Avoid the sale of personal health information.
- Provide transparent data-processing documentation.
- Allow users to disable optional integrations and analytical features.
- Minimize collection and retention of unnecessary personal information.
Accessibility and User Experience
- Provide accessible interactive body diagrams.
- Support screen readers and assistive technologies.
- Offer adjustable text sizes and contrast settings.
- Provide simplified anatomical and medical explanations.
- Support configurable pain scales.
- Include multilingual interface capabilities.
- Allow dashboard customization.
- Support voice-assisted symptom entry.
- Provide optional reminders and wellness check-ins.
- Design visualizations with accessibility in mind.
- Support users with varying levels of medical and technical knowledge.
Optional Plugin Modules
Wearable and Health Data Integration
- Integrate with supported wearable devices and health platforms.
- Support optional Apple Health and other compatible health data sources.
- Import permitted sleep, activity, heart rate, and wellness measurements.
- Correlate wearable measurements with recorded pain history.
- Allow users to control synchronization and permissions.
- Maintain clear distinctions between measured data and user-reported symptoms.
Advanced AI Models
- Support optional locally hosted language models.
- Provide advanced symptom pattern analysis.
- Support multimodal pain-entry analysis.
- Allow specialized AI models for anatomical and traditional medicine references.
- Support retrieval-augmented generation for medical and educational resources.
- Provide configurable AI interpretation models.
- Support model comparison and evaluation.
- Allow users to select available AI processing options.
Expanded Traditional Medicine Libraries
- Incorporate additional Ayurvedic references.
- Expand Traditional Chinese Medicine resources.
- Include Japanese traditional medicine references.
- Support regional acupressure traditions.
- Incorporate historical healing systems and cultural references.
- Provide additional traditional body maps and reference materials.
- Maintain source attribution and cultural context for contributed information.
Practitioner Collaboration
- Support optional healthcare-provider access.
- Allow secure sharing of selected pain history.
- Provide practitioner notes and feedback.
- Generate appointment preparation reports.
- Support patient-controlled sharing permissions.
- Allow users to revoke access to shared information.
- Provide separate access controls for medical and personal journal information.
Research and Community Insights
- Support optional anonymized research contributions.
- Provide aggregated symptom-pattern research.
- Allow community-contributed educational references.
- Support research dataset management.
- Require informed consent for research participation.
- Provide privacy-preserving statistical analysis.
- Allow users to withdraw optional research contributions where supported.
- Distinguish research findings from established clinical recommendations.
Advanced Anatomical Visualization
- Provide optional three-dimensional anatomical models.
- Support interactive muscle, skeletal, neurological, and connective tissue layers.
- Allow visualization of nerve pathways and referred pain regions.
- Overlay Eastern meridians and pressure-point references.
- Support anatomical rotation, zoom, and layer selection.
- Provide educational anatomical exploration tools.
Advanced Wellness Programs
- Provide customizable mindfulness programs.
- Incorporate guided meditation and breathing exercises.
- Support educational movement and mobility programs.
- Include traditional wellness practices.
- Allow users to create personalized wellness routines.
- Track participation and self-reported outcomes.
- Provide optional progress summaries.
Additional Language and Cultural Support
- Expand medical and traditional medicine references across languages.
- Support culturally contextualized terminology.
- Provide translated anatomical and pressure-point references.
- Allow community-supported translations.
- Preserve original terminology alongside translations where appropriate.
AI Architecture and Intelligence
InsightPoint uses a modular AI architecture that separates medical information retrieval, anatomical mapping, traditional medicine references, symptom analysis, and symbolic interpretation.
AI capabilities should include:
- Anatomical location recognition and correlation.
- Cross-system pressure-point mapping.
- Longitudinal symptom analysis.
- Pattern and potential trigger identification.
- Natural language symptom interpretation.
- Contextual self-reflection generation.
- Medical information retrieval with source attribution.
- Confidence scoring and uncertainty communication.
- Medical safety screening and escalation.
- Personalized educational content generation.
- Historical trend analysis.
- Optional multimodal data interpretation.
AI-generated information must clearly identify its category:
- Medical Evidence: Information supported by recognized medical research or clinical references.
- Traditional Medicine: Concepts and associations originating from established traditional healing systems.
- Observed Correlation: Patterns identified from user-provided information without establishing causation.
- Symbolic Interpretation: Cultural, philosophical, or reflective associations intended for personal exploration.
- AI-Generated Suggestion: An educational or self-reflection recommendation generated by an AI model.
The architecture must prevent traditional or symbolic interpretations from being presented as established medical findings.
Specification Branding License (SBL)
Standard
- Fully AGPL-3.0+ compliant system
- Copyleft enforced for network deployments
- Required attribution:
- Roxanne Ardary
- https://www.roxanneardary.com/
Optional
- Specification Branding License (SBL)
- Attribution-free commercial deployment
- Pricing based on scale, usage, and deployment scope
- https://roxanneardary.com/insightpoint/
License & Notice Requirements
InsightPoint is released under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).
By contributing to any Open Arsenal project, you agree that your contributions will also be released under this license.
Please note the following:
- All contributions must comply with the AGPL-3.0+ terms.
- Under Section 7 of the license, all redistributions, forks, and derivative works must preserve attribution to: Roxanne Ardary and roxanneardary.com.
- InsightPoint specifications are free to use with attribution. A Specification Branding License can be negotiated upon request.
- The project’s notice.md file tracks attribution requirements and contributor acknowledgments. Any update that adds new contributors or modifies attribution should also update
notice.md. - When submitting a pull request, ensure that any new files maintain the attribution headers where applicable.
- Network-deployed versions of this software must also remain fully AGPL-3.0+ compliant, including exposure of source code modifications when applicable under the license.
For full legal details, please refer to the AGPL-3.0+ license and the project’s notice.md file.
Notice – InsightPoint
Attribution Requirement: Under Section 7 of the AGPL 3.0+ license, all redistributions, forks, and derivative works, including network-deployed versions of this project, must provide attribution to Roxanne Ardary and roxanneardary.com.
Contributors
This file tracks contributors and their specific contributions to the project.
- Roxanne Ardary, roxanneardary.com – November 19, 2026
Created the repository for InsightPoint. Developed the project concept and specifications for an AI-powered pain tracking and body-awareness platform integrating Western anatomy, Eastern medicine, pressure-point and meridian mapping, AI-driven symptom analysis, symbolic interpretations, and guided self-evaluation. - [Add other contributors here] – [Date]
[Describe contribution in one sentence]
License – InsightPoint
This repository is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).
Key Points:
- You are free to use, modify, and distribute the code.
- All redistributions, forks, and derivative works or network-deployed versions must also be licensed under AGPL-3.0+ and provide attribution to Roxanne Ardary and roxanneardary.com as required under Section 7 of the license.
- The software is provided “as is,” without warranty of any kind.
For the full license text, see GNU AGPL-3.0 License.



