Skip to content

Improve Tachyon UX #142927

Open
Open
Improve Tachyon UX#142927
Labels
3.15bugs and security fixesstdlibStandard Library Python modules in the Lib/ directorytopic-profilingtype-featureA feature request or enhancement

Description

@pablogsal
pablogsal
opened on Dec 18, 2025

This is a meta issue to group all the items to improve the UX of the tachyon profiler.

Tasks

CLI

  • Standardize timing arguments — Currently mixing µs and seconds for related timing args, which is confusing
  • Duration should default to "until done" - The fact that we sample only for 10 seconds by default is confusing to users and a bad experience

Workflow

  • Auto-open browser with results — Reduce manual steps in the workflow; add --no-browser flag to disable

Flamegraph

  • Hide runner/bootstrap frames by default — Top rows showing interpreter startup aren't useful for most profiling tasks
  • The Gil/gc/exception indicators could be progress bars — this probably will show the information more clearly and take less space
  • Show module names instead of full file paths — /home/user/project/pkg/mod.py → pkg.mod for readability
  • Show "self" time for functions — Display time spent in function body excluding callees, not just total inclusive time
  • Move hotspots to top of sidebar — This is the most important info; currently buried below logo and stats
  • Fix inverted flamegraph width — Currently shows narrow chart when leaves sum to small percentage, wasting screen space

Pstats

  • Fix docs: -o output format — Docs imply text output but it's actually binary pstats format
  • Standardize --pstats behavior — Output format differs significantly with/without -o flag, which is unexpected

Thanks @dmoisset 🖤

Linked PRs

Activity

  1. pablogsal commented on Dec 18, 2025

    @pablogsal
    pablogsal
    on Dec 18, 2025
    MemberAuthor

    CC @ivonastojanovic @lkollar

  2. pablogsal commented on Dec 18, 2025

    @pablogsal
    pablogsal
    on Dec 18, 2025
    MemberAuthor

    Please say what items you plan to work on to avoid collisions

  3. StanFromIreland
    added
    type-featureA feature request or enhancement
    stdlibStandard Library Python modules in the Lib/ directory
    3.15bugs and security fixes
    topic-profiling
    on Dec 18, 2025
  4. pablogsal
    added a commit that references this issue on Dec 20, 2025

    gh-142927: Tachyon: Start with user's default light/dark theme (#142987)

    5b52636
  5. cocolato
    added a commit that references this issue on Dec 22, 2025

    pythongh-142927: Tachyon: Start with user's default light/dark theme (p…

    c132658

  6. lkollar commented on Dec 22, 2025

    @lkollar
    lkollar
    on Dec 22, 2025
    Contributor
    • Standardize timing arguments — Currently mixing µs and seconds for related timing args, which is confusing
    • Duration should default to "until done" - The fact that we sample only for 10 seconds by default is confusing to users and a bad experience

    I'll take these.

  7. ivonastojanovic commented on Dec 22, 2025

    @ivonastojanovic
    ivonastojanovic
    on Dec 22, 2025
    Contributor
    • Auto-open browser with results — Reduce manual steps in the workflow; add --no-browser flag to disable
    • Hide runner/bootstrap frames by default — Top rows showing interpreter startup aren't useful for most profiling tasks
    • The Gil/gc/exception indicators could be progress bars — this probably will show the information more clearly and take less space

    I'll take these

  8. pablogsal
    added 2 commits that reference this issue on Dec 22, 2025

    gh-142927: Tachyon: Comma separate thousands and fix singular/plurals (…

    ff7f62e

    gh-142927: Tachyon: Fix contrast ratio in top panel (#142936)

    ea3fd78
  9. pablogsal
    added a parent issue on Dec 25, 2025
  10. pablogsal
    removed a parent issue on Dec 25, 2025
  11. pablogsal
    added a parent issue on Dec 25, 2025

  12. 17 remaining items

  13. hugovk commented on Mar 2, 2026

    @hugovk
    hugovk
    on Mar 2, 2026
    Member
    • Move hotspots to top of sidebar — This is the most important info; currently buried below logo and stats

    See PR http://github.com/python/cpython/pull/145428.

  14. hugovk
    added a commit that references this issue on Mar 10, 2026

    gh-142927: Detect system theme in flame graph like in heatmap (#144885)

    368a267

  15. ivonastojanovic commented on Mar 16, 2026

    @ivonastojanovic
    ivonastojanovic
    on Mar 16, 2026
    Contributor

    Show module names instead of full file paths — /home/user/project/pkg/mod.py → pkg.mod for readability

    #146040 should fix this.

    Show "self" time for functions — Display time spent in function body excluding callees, not just total inclusive time

    @pablogsal #145785 adds tracking for self time, but currently we only update the differential flamegraph there. Would you prefer that I open a separate PR to make this change outside of #145785, or should we handle the regular flamegraphs as a follow-up once #145785 is merged?

  16. pablogsal
    added a commit that references this issue on Mar 16, 2026

    gh-142927: Move hotspots up flamegraph sidebar (#145428)

    104cae0

  17. ivonastojanovic commented on Mar 31, 2026

    @ivonastojanovic
    ivonastojanovic
    on Mar 31, 2026
    Contributor

    Show "self" time for functions — Display time spent in function body excluding callees, not just total inclusive time

    #147706 should fix this.

  18. pablogsal
    added a commit that references this issue on Apr 4, 2026

    gh-142927: Show self time in flamegraph tooltip (#147706)

    4ff8b07
  19. Wulian233
    added a commit that references this issue on Apr 5, 2026

    pythongh-142927: Add scrollbar support to Tachyon HTML dark mode

    c8881b9
  20. ljfp
    added 4 commits that reference this issue on Apr 25, 2026

    pythongh-142927: Tachyon: Fix singular and plurals (python#145329)

    7ba9e6f

    pythongh-142927: Detect system theme in flame graph like in heatmap (p…

    5565280

    pythongh-142927: Move hotspots up flamegraph sidebar (python#145428)

    f1935ce

    pythongh-142927: Show self time in flamegraph tooltip (python#147706)

    dec2002
  21. pablogsal
    added 2 commits that reference this issue on Apr 28, 2026

    gh-142927: Fix inverted flamegraph width (#148568)

    993e204

    gh-142927: Show module names instead of file paths in flamegraph (#14…

    d4eee16
  22. hugovk
    added 2 commits that reference this issue on Oct 9, 2026

    gh-142927: Update Tachyon examples (#159050)

    c524b30

    [3.15] gh-142927: Update Tachyon examples (GH-159050) (#159052)

    e5f271f
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    3.15bugs and security fixesstdlibStandard Library Python modules in the Lib/ directorytopic-profilingtype-featureA feature request or enhancement

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions