{"id":51095583,"url":"https://github.com/soil-dev/dope-plot","last_synced_at":"2026-06-24T06:02:02.002Z","repository":{"id":272262889,"uuid":"916006483","full_name":"soil-dev/dope-plot","owner":"soil-dev","description":"Radar, quadrant and comparison charts for TICK four-bird personality profiles — CLI and MCP server","archived":false,"fork":false,"pushed_at":"2026-06-02T08:20:19.000Z","size":114332,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-06-02T10:17:25.786Z","etag":null,"topics":["personality-profiling","tick"],"latest_commit_sha":null,"homepage":"https://github.com/soil-dev/bird-plot","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/soil-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-01-13T09:24:29.000Z","updated_at":"2026-06-02T08:20:37.000Z","dependencies_parsed_at":"2025-02-21T12:20:15.075Z","dependency_job_id":"2ee6c06f-9bf4-45d9-afa0-3272128443bb","html_url":"https://github.com/soil-dev/dope-plot","commit_stats":null,"previous_names":["arapov/bird-plot","arapov/dope-plot","soil-dev/dope-plot"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/soil-dev/dope-plot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soil-dev%2Fdope-plot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soil-dev%2Fdope-plot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soil-dev%2Fdope-plot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soil-dev%2Fdope-plot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/soil-dev","download_url":"https://codeload.github.com/soil-dev/dope-plot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soil-dev%2Fdope-plot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34719307,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-24T02:00:07.484Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["personality-profiling","tick"],"created_at":"2026-06-24T06:01:58.039Z","updated_at":"2026-06-24T06:02:01.845Z","avatar_url":"https://github.com/soil-dev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dope-Plot\n\n**Dope-Plot** is a Python-based visualization tool for generating quadrant-style plots of [tick.com.au](https://tick.com.au)’s four-bird personality styles (Eagle, Dove, Owl, and Peacock). It takes as input a data file (e.g., CSV) of individual or group personality scores and produces informative charts that help users quickly see:\n\n- **Individual** personality radar plots\n- **Team** or **group** distributions in a quadrant layout\n- **Pairwise** comparisons (overlap of two individuals’ personalities)\n\n…either from the command line or straight from an AI assistant via the bundled\n[MCP server](#use-from-ai-assistants-mcp).\n\nThese plots are especially useful for workshops, coaching sessions, and team-building exercises, as they visualize how individuals align or differ on the four “bird” dimensions.\n\n### The four birds\n\nEach person scores on four traits, and the scatter plot places them on a\nquadrant defined by two axes: **assertive ↔ reserved** (horizontal) and\n**people-oriented ↔ task-oriented** (vertical).\n\n| Bird | Quadrant | Style | Tends to be |\n| --- | --- | --- | --- |\n| **Dove** | top-right | Supportive \u0026 Caring | warm, people-oriented, reserved |\n| **Peacock** | top-left | Talkative \u0026 Dramatic | warm, people-oriented, assertive |\n| **Eagle** | bottom-left | Controlling \u0026 Forceful | task-oriented, assertive |\n| **Owl** | bottom-right | Analytical \u0026 Logical | task-oriented, reserved |\n\nMost people lead with one bird (their *primary*) and lean on a second\n(*secondary*); the charts show that blend rather than forcing a single label.\n\n[The Tick personality profiling system](https://tick.com.au) has been appreciated by many in the fields of sales training, leadership coaching, and personal development for its simplicity and ease of communication. Dope-Plot leverages this established framework to provide clear, accessible visualizations that help users understand and compare personality traits quickly. While the tool provides valuable insights and serves as a catalyst for discussion and reflection, users are encouraged to complement these insights with additional information and professional judgment.\n\n---\n\n## Table of Contents\n\n1. [Features](#features)\n2. [Installation](#installation)\n3. [Usage](#usage)\n4. [Input Data Format](#input-data-format)\n5. [Use from AI assistants (MCP)](#use-from-ai-assistants-mcp)\n6. [Testing](#testing)\n7. [Example Outputs](#example-outputs)\n8. [Design Notes](#design-notes)\n\n---\n\n## Features\n\n- **Radar Plot** for individuals:\n\n  - Shows how a single person’s personality scores map onto the four quadrants.\n  - A polygon connecting each dimension’s score.\n\n- **Team/Group Distribution**:\n\n  - Plots multiple people on a quadrant-based chart, illustrating the distribution of personalities in a single view.\n  - Useful for quickly identifying group strengths, diversity, and potential gaps.\n\n- **Pairwise Comparison**:\n  - Overlays two individuals’ radar polygons on the same chart to highlight similarities and differences.\n  - Displays a percentage overlap for a quick gauge of alignment.\n\n---\n\n## Installation\n\n1. **Clone or Download the Repository**\n\n```bash\ngit clone https://github.com/soil-dev/dope-plot.git\ncd dope-plot\n```\n\n2. **Install Dependencies with Poetry**\n\nThis project uses [Poetry](https://python-poetry.org/) for dependency management.\n\n```bash\npoetry install\n```\n\n3. **(Optional) Activate the Virtual Environment**\n\n```bash\npoetry env activate\n```\n\n(On Poetry 2.x `poetry shell` moved to a plugin; `poetry env activate` prints the\nactivation command.) Or you can use `poetry run ...` without activating the shell.\n\n4. **Verify Installation**\n\n```bash\npoetry run dope-plot --help\n```\n\nThis should display a help message with usage instructions.\n\n## Usage\n\n1. **Prepare Your Data**\n   Ensure you have a CSV or similar data file that includes each person’s scores. (See [Input Data Format](#input-data-format) below.)\n\n2. **Run Dope-Plot**\n\n```bash\npoetry run dope-plot --data data.csv --graph radar scatter\n```\n\n- --data Path to the CSV data file (default: data.csv)\n- --graph Type of graph to generate (radar or scatter)\n- --config Optional path to a TOML config file. If omitted, Dope-Plot uses\n  `./config.toml` when present, otherwise its bundled defaults.\n\n3. **Check Generated Plots**\n\nThe script will create .png files in the charts folder.\n\n_Note: Run `poetry run dope-plot --help` for detailed usage._\n\n## Input Data Format\n\n| Name  | Dove | Eagle | Owl | Peacock | Note |\n| ----- | ---- | ----- | --- | ------- | ---- |\n| Grace | 15   | 12    | 5   | 17      | P/D  |\n| Henry | 4    | 10    | 12  | 0       | O/E  |\n| ...   | ...  | ...   | ... | ...     | ...  |\n\n- **Name**: The individual’s name or identifier.\n- **Dove, Eagle, Owl, Peacock**: Numeric scores representing each “bird” trait.\n- **Note**: Individual's primary and secondary dominant \"bird\" traits, separated by a forward slash.\n\n## Use from AI assistants (MCP)\n\nDope-Plot ships a [Model Context Protocol](https://modelcontextprotocol.io)\nserver so AI assistants can generate charts directly, getting the rendered PNG\nback inline. It works with any MCP-capable client (Claude Desktop/Code, n8n's\nMCP node, OpenAI agents, …).\n\nInstall with the optional `mcp` extra and run the server (it speaks MCP over\nstdio):\n\n```bash\npip install 'dope-plot[mcp]'\ndope-plot-mcp\n```\n\nThen register it in your client. For example, Claude Desktop\n(`claude_desktop_config.json`) or Claude Code (`.mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"dope-plot\": { \"command\": \"dope-plot-mcp\" }\n  }\n}\n```\n\nTools exposed (each returns a PNG):\n\n- **`scatter_chart(csv)`** — the group quadrant plot from CSV text\n  (`Name,Dove,Eagle,Owl,Peacock[,Note]`).\n- **`radar_chart(name, dove, eagle, owl, peacock, note=\"\")`** — one person's radar.\n- **`comparison_chart(...two people's scores...)`** — overlay two radars with an\n  overlap percentage.\n\nNo `config.toml` is required — the server uses the bundled defaults and assets.\n\n## Testing\n\nRun the test suite with:\n\n```bash\npoetry run pytest\n```\n\n## Example Outputs\n\n1. **Individual Radar Plot**\n\n- Plots one person’s scores around four axes (Eagle, Dove, Owl, Peacock).\n- The polygon edges connect each axis’s numeric value, visually representing personality strengths.\n\n\u003cimg src=\"https://media.githubusercontent.com/media/soil-dev/dope-plot/refs/heads/master/charts/Grace/radar_Grace.png\" width=\"555\"\u003e\n\n2. **Group/Team Distribution - Scatter Plot**\n\n- Displays multiple names on a quadrant chart.\n- Each quadrant corresponds to a “bird” style, with positions indicating how strongly each person aligns to one or more dimensions.\n\n\u003cimg src=\"https://media.githubusercontent.com/media/soil-dev/dope-plot/refs/heads/master/charts/scatter_all.png\" width=\"555\"\u003e\n\n3. **Comparison/Overlap Plot**\n\n- Overlays two radar plots for a side-by-side comparison.\n- Shows an “Overlap” percentage as a measure of similarity.\n\n\u003cimg src=\"https://media.githubusercontent.com/media/soil-dev/dope-plot/refs/heads/master/charts/Grace/compare/with_Henry.png\" width=\"555\"\u003e\n\n_(Note: The above images are illustrative examples.)_\n\n## Design Notes\n\nThe scatter plot scales each cohort to fill the quadrants so that name boxes\nspread out instead of colliding. This is a deliberate trade-off (positions are\nrelative to the loaded group, not absolute). See\n[docs/DESIGN.md](docs/DESIGN.md) for the rationale and before/after examples.\n\n## License\n\nThis project is licensed under the [Apache 2.0 License](LICENSE). You are free to use, modify, and distribute this software in accordance with the license terms.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoil-dev%2Fdope-plot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsoil-dev%2Fdope-plot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoil-dev%2Fdope-plot/lists"}