HTh S r SSKJr SSKJrJrJrJr SSKJ r SSK
J r SSK J
r
SSKJr SS KJr S
r\( a SS KJr " S S
\5 rg! \ a SS KJr S r N*! \ a \rS r N7f = ff = f)zFContains a logger to push training logs to the Hub, using Tensorboard. )Path)
TYPE_CHECKINGListOptionalUnion )CommitScheduler)EntryNotFoundError) ModelCard) experimental)
SummaryWriterTFc ^ \ rS rSrSr\SU 4S jj5 rSSSSSSSSSSS .
S
\S \\ S \ \
\ 4 S
\ S\\ S\\ S\\ S\\ S\\ \
\ \4 S\\ \
\ \4 S\\ 4U 4S jjjrU 4S jrSrU =r$ )HFSummaryWriter/ a
Wrapper around the tensorboard's `SummaryWriter` to push training logs to the Hub.
Data is logged locally and then pushed to the Hub asynchronously. Pushing data to the Hub is done in a separate
thread to avoid blocking the training script. In particular, if the upload fails for any reason (e.g. a connection
issue), the main script will not be interrupted. Data is automatically pushed to the Hub every `commit_every`
minutes (default to every 5 minutes).
`HFSummaryWriter` is experimental. Its API is subject to change in the future without prior notice.
Args:
repo_id (`str`):
The id of the repo to which the logs will be pushed.
logdir (`str`, *optional*):
The directory where the logs will be written. If not specified, a local directory will be created by the
underlying `SummaryWriter` object.
commit_every (`int` or `float`, *optional*):
The frequency (in minutes) at which the logs will be pushed to the Hub. Defaults to 5 minutes.
squash_history (`bool`, *optional*):
Whether to squash the history of the repo after each commit. Defaults to `False`. Squashing commits is
useful to avoid degraded performances on the repo when it grows too large.
repo_type (`str`, *optional*):
The type of the repo to which the logs will be pushed. Defaults to "model".
repo_revision (`str`, *optional*):
The revision of the repo to which the logs will be pushed. Defaults to "main".
repo_private (`bool`, *optional*):
Whether to make the repo private. If `None` (default), the repo will be public unless the organization's default is private. This value is ignored if the repo already exists.
path_in_repo (`str`, *optional*):
The path to the folder in the repo where the logs will be pushed. Defaults to "tensorboard/".
repo_allow_patterns (`List[str]` or `str`, *optional*):
A list of patterns to include in the upload. Defaults to `"*.tfevents.*"`. Check out the
[upload guide](https://huggingface.co/docs/huggingface_hub/guides/upload#upload-a-folder) for more details.
repo_ignore_patterns (`List[str]` or `str`, *optional*):
A list of patterns to exclude in the upload. Check out the
[upload guide](https://huggingface.co/docs/huggingface_hub/guides/upload#upload-a-folder) for more details.
token (`str`, *optional*):
Authentication token. Will default to the stored token. See https://huggingface.co/settings/token for more
details
kwargs:
Additional keyword arguments passed to `SummaryWriter`.
Examples:
```diff
# Taken from https://pytorch.org/docs/stable/tensorboard.html
- from torch.utils.tensorboard import SummaryWriter
+ from huggingface_hub import HFSummaryWriter
import numpy as np
- writer = SummaryWriter()
+ writer = HFSummaryWriter(repo_id="username/my-trained-model")
for n_iter in range(100):
writer.add_scalar('Loss/train', np.random.random(), n_iter)
writer.add_scalar('Loss/test', np.random.random(), n_iter)
writer.add_scalar('Accuracy/train', np.random.random(), n_iter)
writer.add_scalar('Accuracy/test', np.random.random(), n_iter)
```
```py
>>> from huggingface_hub import HFSummaryWriter
# Logs are automatically pushed every 15 minutes (5 by default) + when exiting the context manager
>>> with HFSummaryWriter(repo_id="test_hf_logger", commit_every=15) as logger:
... logger.add_scalar("a", 1)
... logger.add_scalar("b", 2)
```
c N > [ ( d [ S5 e[ TU ]
U 5 $ )NzvYou must have `tensorboard` installed to use `HFSummaryWriter`. Please run `pip install --upgrade tensorboardX` first.)is_summary_writer_available ImportErrorsuper__new__)clsargskwargs __class__s [/var/www/auris/envauris/lib/python3.13/site-packages/huggingface_hub/_tensorboard_logger.pyr HFSummaryWriter.__new__y s, ** (
ws## N F tensorboardz *.tfevents.*)
logdir commit_everysquash_history repo_type
repo_revision repo_private path_in_reporepo_allow_patternsrepo_ignore_patternstokenrepo_idr r r! r" r# r$ r% r& r' r( c
> [ TU ] " S SU0U D6 [ U R [ 5 ( d/ [ SU R S[
U R 5 S35 eUb US:X a [ U R 5 R nO4UR S5 S- [ U R 5 R - n[ U R UUUUUU U U
UUS9 U l U R R U l U R R U l
U R R U l [ R" " U R U R S9n
U
R& R) S / 5 nS
U; aD UR+ S
5 XR& S ' U
R- U R U R S 9 g g ! [$ a [! S5 n
N~f = f)
Nr z%`self.logdir` must be a string. Got 'z
' of type . /) folder_pathr% r) r" revisionprivater( allow_patternsignore_patternseveryr! )repo_id_or_pathr" tagszhf-summary-writer)r) r" )r __init__
isinstancer str
ValueErrortyper namestripr schedulerr) r" r/ r# r loadr
datagetappend push_to_hub)selfr) r r r! r" r# r$ r% r& r' r( r cardr5 r s r r7 HFSummaryWriter.__init__ s " 11&1 $++s++ DT[[MQ[\`aealal\m[nno pq q <2#5 ,11L'--c2S84 ;L;Q;QQL ) % " . 0 )
~~-- 11 !^^ 4 4 ! >>$,,$..YD yy}}VR( d * KK+ , $IIf T\\T^^ L + " ! R=D !s 3)G GGc z > [ TU ] XU5 U R R 5 nUR 5 g)zLPush to hub in a non-blocking way when exiting the logger's context manager.N)r __exit__r> triggerresult)rD exc_typeexc_valexc_tbfuturer s r rH HFSummaryWriter.__exit__ s-
F3 '')
r )r) r# r" r> )returnr )__name__
__module__ __qualname____firstlineno____doc__r r r9 r r intfloatboolr r7 rH __static_attributes__
__classcell__)r s @r r r / s GR $ $ !%*+ $#''+'+&3?M@D #:M:M
:M
CJ' :M
:M C=:M }:M tn:M sm:M &eDIsN&; <:M 'uT#Y^'< =:M }:M :Mx r r N)rU pathlibr typingr r r r _commit_schedulerr errorsr
repocardr utilsr tensorboardXr
r r torch.utils.tensorboardobjectr r6 r r rd s} M 7 7 . &
,*"& *Sm S ,,9&+# ,
&+#, ,s) A A2A
A.*A2-A..A2