insper-mlops 0.1.0__py3-none-any.whl

insper_mlops-0.1.0.dist-info/METADATA

@@ -0,0 +1,57 @@
+Metadata-Version: 2.4
+Name: insper-mlops
+Version: 0.1.0
+Summary: A command-line tool to standardize the creation of MLOps projects at Insper CDIA.
+Author-email: Insper CDIA <cdia@insper.edu.br>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/centro-dados-ia/insper-mlops
+Project-URL: Bug Tracker, https://github.com/centro-dados-ia/insper-mlops/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: GitPython
+Requires-Dist: PyGithub>=2.0.0
+Requires-Dist: typer[all]
+Requires-Dist: requests
+Dynamic: license-file
+
+# MLOps Template
+
+🚀 Ferramenta de linha de comando para padronizar e automatizar projetos de MLOps no Insper CDIA.
+
+## Instalação
+
+```bash
+pip install insper-mlops
+```
+
+## Uso
+
+```bash
+mlops start
+```
+
+Siga as instruções no terminal para criar seu repositório de MLOps.
+
+## Funcionalidades
+
+- ✅ Criação automática de repositórios GitHub
+- ✅ Configuração de branches (dev/prod)
+- ✅ Aplicação de regras de proteção de branch
+- ✅ Configuração de permissões de equipe
+- ✅ Templates pré-configurados para diferentes perfis
+
+## Requisitos
+
+- Python 3.8+
+- GitHub CLI (`gh`) instalado
+- Conta GitHub com acesso às organizações Insper
+
+## Licença
+
+MIT License - veja o arquivo [LICENSE](LICENSE) para detalhes.

insper_mlops-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+insper_mlops-0.1.0.dist-info/licenses/LICENSE,sha256=fyMKVo-Zc6ujqbXAfU2DyKDcMJAL9sPsKa7xyNDMSy0,1089
+mlopstemplate/__init__.py,sha256=yg-KaUTCBpIh_lrtwAR3rXc5Vx1uENenJbc6BhmmkUw,170
+mlopstemplate/cli.py,sha256=C2ZmLTSQEMtdezIVM9_tuUxHdgx5PFLlWy1wN8oPXxI,10939
+mlopstemplate/config.py,sha256=D3pliugZp7kxABlbqMlC6YUknvpMmREJVSE-b7IGHBE,1314
+mlopstemplate/core.py,sha256=aZYVuscAiiYqCL1SQoZmMWLZXTblptgyCadhS6lR3o0,8523
+insper_mlops-0.1.0.dist-info/METADATA,sha256=zVWnwITnVG_oz7gIdKI67fZUzpmnptzYGwzqITT19fI,1619
+insper_mlops-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+insper_mlops-0.1.0.dist-info/entry_points.txt,sha256=Hj2mv_faG2PncP8n-Zuyt6-Qr52BWoNQffgFQsQVuy8,48
+insper_mlops-0.1.0.dist-info/top_level.txt,sha256=-uTjn-a-Bxr2Yn41ZsLF57wIYIEJd2kI09ovnkA5quk,14
+insper_mlops-0.1.0.dist-info/RECORD,,

insper_mlops-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

insper_mlops-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mlops = mlopstemplate.cli:app

insper_mlops-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Insper CDIA
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

insper_mlops-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+mlopstemplate

mlopstemplate/__init__.py

@@ -0,0 +1,5 @@
+"""MLOps Template - Ferramenta para padronizar projetos de MLOps no Insper CDIA."""
+
+__version__ = "0.1.0"
+__author__ = "Insper CDIA"
+__email__ = "cdia@insper.edu.br"

mlopstemplate/cli.py

@@ -0,0 +1,286 @@
+"""Command-line interface for the MLOps Template tool."""
+
+import os
+import subprocess
+
+import typer
+from rich.console import Console
+from rich.panel import Panel
+
+from mlopstemplate import config, core
+
+app = typer.Typer(
+    help="🚀 Ferramenta de linha de comando para padronizar e automatizar projetos de MLOps no Insper.",
+    add_completion=False,
+)
+console = Console()
+
+def get_token_from_gh_cli() -> str:
+    """
+    Retrieves the GitHub authentication token from the GitHub CLI.
+
+    This function first checks if the user is authenticated. If not, it
+    initiates the interactive login process for the user to authenticate.
+
+    Returns:
+        The GitHub authentication token.
+
+    Raises:
+        typer.Exit: If the GitHub CLI is not installed or if the login
+                    process fails.
+    """
+    # 1. Verifica se o GitHub CLI (gh) está instalado
+    try:
+        subprocess.run(
+            ["gh", "--version"], capture_output=True, check=True, text=True
+        )
+    except FileNotFoundError:
+        console.print(
+            "[bold red]❌ GitHub CLI (gh) não encontrado. "
+            "Instale em https://cli.github.com/ e tente novamente.[/bold red]"
+        )
+        raise typer.Exit(code=1)
+
+    # 2. Tenta obter o token silenciosamente
+    result = subprocess.run(["gh", "auth", "token"], capture_output=True, text=True)
+    if result.returncode == 0 and result.stdout.strip():
+        return result.stdout.strip()
+
+    # 3. Se não houver token, inicia o processo de login interativo
+    console.print(
+        Panel(
+            "[bold yellow]🔐 GitHub CLI não está autenticado.[/bold yellow]\\n\\n"
+            "Iniciando processo de login interativo. "
+            "Por favor, siga as instruções no seu terminal e navegador.",
+            title="Ação Necessária",
+            border_style="yellow",
+        )
+    )
+
+    try:
+        subprocess.run(["gh", "auth", "login"], check=True)
+    except subprocess.CalledProcessError:
+        console.print(
+            "[bold red]❌ O processo de login com o GitHub CLI falhou ou foi cancelado.[/bold red]"
+        )
+        raise typer.Exit(code=1)
+
+    # 4. Após o login, tenta obter o token novamente
+    console.print("✅ [bold green]Autenticação concluída.[/bold green] Verificando token...")
+    result = subprocess.run(["gh", "auth", "token"], capture_output=True, text=True)
+
+    if result.returncode == 0 and result.stdout.strip():
+        return result.stdout.strip()
+    else:
+        console.print(
+            "[bold red]❌ Falha ao obter o token após o login. "
+            "Por favor, tente 'mlops login' novamente.[/bold red]"
+        )
+        raise typer.Exit(code=1)
+
+
+@app.command(hidden=True)
+def login(
+    temp: bool = typer.Option(
+        False, "--temp-login", help="Login temporário, não salva token em arquivo"
+    )
+):
+    """
+    Authenticates the user via GitHub CLI and saves the token.
+    """
+    console.print("🔐 Verificando autenticação via GitHub CLI...")
+    token = get_token_from_gh_cli()
+
+    if temp:
+        config.set_session_token(token)
+        console.print("⚠️  [yellow]Login temporário. Token armazenado apenas nesta sessão.[/yellow]")
+    else:
+        config.save_token(token)
+
+    console.print("✅ [bold green]Login bem-sucedido![/bold green]")
+
+@app.command(hidden=True)
+def make_repo_pesq(nome: str):
+    """
+    Clones the base MLOps template for the 'Pesquisa' profile.
+    (This command is intended for internal use by the 'start' command).
+    """
+    token = config.get_token()
+    core.clonar_template_com_nome(
+        config.TEMPLATE_REPO_URL_PESQUISA.format(token=token), nome
+    )
+
+@app.command(hidden=True)
+def make_repo(nome: str):
+    """
+    Clones the base MLOps template repository into a new directory.
+    """
+    token = config.get_token()
+    core.clonar_template_com_nome(
+        config.TEMPLATE_REPO_URL.format(token=token), nome
+    )
+
+def _start_pesquisador_flow():
+    """Handles the workflow for the 'Pesquisador' profile."""
+    console.print(Panel(
+        "[bold yellow]⚠️ Para criar repositórios na organização 'Insper-CDIA-Pesquisa', você precisa estar autenticado com uma conta que tenha acesso a ela.[/bold yellow]\n\n"
+        "Se você já estiver logado com outra conta no GitHub CLI, recomenda-se fazer logout antes de prosseguir.",
+        title="Atenção",
+        border_style="yellow"
+    ))
+
+    resposta = typer.confirm("Deseja fazer logout do GitHub CLI antes de continuar?", default=True)
+    if resposta:
+        console.print("🔐 Fazendo logout do GitHub CLI...")
+        subprocess.run(["gh", "auth", "logout", "--hostname", "github.com"], check=False)
+
+    console.print("🔑 Iniciando processo de login com a conta certa (use o navegador quando solicitado)...")
+    login(temp=True)  # Força novo login via GitHub CLI, armazena token somente na sessão
+
+    repo_nome = typer.prompt("Qual o nome do repositório que você deseja criar?")
+    make_repo_pesq(repo_nome)
+    console.print(f"✅ Repositório '[bold cyan]{repo_nome}[/bold cyan]' criado com sucesso!")
+
+    # Automatically upload the repository to GitHub
+    console.print("🚀 Enviando repositório para o GitHub...")
+    token = config.get_token()
+    org_name = "Insper-CDIA-Pesquisa"
+    pasta_projeto = os.path.join(".", repo_nome)
+
+    core.criar_repositorio(token, org_name, pasta_projeto, repo_type="pesquisa")
+    console.print(
+        Panel(
+            "✅ [bold green]Processo concluído com sucesso![/bold green]",
+            title="Finalizado",
+            border_style="green",
+        )
+    )
+
+def _start_administrativo_flow():
+    """Handles the workflow for the 'Administrativo' profile."""
+    console.print(Panel(
+        "[bold yellow]⚠️ Para criar repositórios na organização 'centro-dados-ia', você precisa estar autenticado com uma conta que tenha acesso a ela.[/bold yellow]\n\n"
+        "Se você já estiver logado com outra conta no GitHub CLI, recomenda-se fazer logout antes de prosseguir.",
+        title="Atenção",
+        border_style="yellow"
+    ))
+
+    resposta = typer.confirm("Deseja fazer logout do GitHub CLI antes de continuar?", default=True)
+    if resposta:
+        console.print("🔐 Fazendo logout do GitHub CLI...")
+        subprocess.run(["gh", "auth", "logout", "--hostname", "github.com"], check=False)
+
+    console.print("🔑 Iniciando processo de login com a conta certa (use o navegador quando solicitado)...")
+    login(temp=True)  # Força novo login via GitHub CLI, armazena token somente na sessão
+
+    repo_nome = typer.prompt("Qual o nome do repositório que você deseja criar a partir do template?")
+    make_repo(repo_nome)
+    console.print(f"✅ Repositório '[bold cyan]{repo_nome}[/bold cyan]' criado com sucesso!")
+
+    console.print("🚀 Enviando repositório para o GitHub com branches dev e prod...")
+    token = config.get_token()
+    org_name = "centro-dados-ia"
+    pasta_projeto = os.path.join(".", repo_nome)
+
+    try:
+        core.criar_repositorio(token, org_name, pasta_projeto, repo_type="administrativo")
+        console.print(
+            Panel(
+                "✅ [bold green]Processo concluído com sucesso![/bold green]\n\n",
+                title="Finalizado",
+                border_style="green",
+            )
+        )
+    except Exception as e:
+        console.print(Panel(
+            f"[bold red]❌ Erro durante a criação do repositório:[/bold red]\n\n{str(e)}",
+            title="Erro",
+            border_style="red"
+        ))
+
+def _check_directory_is_project_root():
+    """
+    Checks if the current directory is a valid project root.
+
+    If the directory contains only one subdirectory, it suggests the user
+    to change into that directory.
+    """
+    items = os.listdir(".")
+    dirs = [d for d in items if os.path.isdir(d) and not d.startswith(".")]
+    files = [f for f in items if os.path.isfile(f)]
+
+    if len(dirs) == 1 and not files:
+        project_dir = dirs[0]
+        console.print(
+            Panel(
+                f"❌ [bold red]Comando executado no diretório errado.[/bold red]\\n\\n"
+                f"Parece que seu projeto está na pasta '[bold cyan]{project_dir}[/bold cyan]'.\\n"
+                f"Por favor, entre na pasta do projeto e tente novamente:\\n\\n"
+                f"[green]cd {project_dir}[/green]\\n"
+                f"[green]mlops upload-repo[/green]",
+                title="Erro de Diretório",
+                border_style="red",
+            )
+        )
+        raise typer.Exit(code=1)
+
+
+@app.command(hidden=True)
+def upload_repo():
+    """
+    Creates a GitHub repository from the current directory and uploads the files.
+
+    This command guides the user to select an organization and then triggers
+    the repository creation and configuration process.
+    """
+    _check_directory_is_project_root()
+
+    console.print(
+        Panel(
+            "[bold]Em qual organização você deseja criar o repositório?[/bold]",
+            title="Seleção de Organização",
+            border_style="blue",
+        )
+    )
+    console.print("  [cyan]1[/cyan]: Pesquisa (Insper-CDIA-Pesquisa)")
+    console.print("  [cyan]2[/cyan]: Administrativo (centro-dados-ia)")
+    choice = typer.prompt("Digite o número da opção")
+
+    if choice == "1":
+        org_name = "Insper-CDIA-Pesquisa"
+        repo_type = "pesquisa"
+    elif choice == "2":
+        org_name = "centro-dados-ia"
+        repo_type = "administrativo"
+    else:
+        console.print("[bold red]❌ Opção inválida. Por favor, digite 1 ou 2.[/bold red]")
+        raise typer.Exit(code=1)
+
+    token = config.get_token()
+    pasta_atual = "."
+
+    core.criar_repositorio(token, org_name, pasta_atual, repo_type=repo_type)
+    console.print(
+        Panel(
+            "✅ [bold green]Processo concluído com sucesso![/bold green]",
+            title="Finalizado",
+            border_style="green",
+        )
+    )
+
+@app.command()
+def start():
+    """Starts the interactive setup process for a new MLOps project."""
+    console.print(Panel("[bold green]Bem-vindo à biblioteca MLOps Insper![/bold green]", title="👋 Boas-vindas"))
+    console.print("Para começar, por favor, selecione o seu perfil:")
+    console.print("  [cyan]1[/cyan]: Pesquisador")
+    console.print("  [cyan]2[/cyan]: Administrativo")
+    choice = typer.prompt("Digite o número da opção")
+
+    if choice == "1":
+        _start_pesquisador_flow()
+    elif choice == "2":
+        _start_administrativo_flow()
+    else:
+        console.print("[bold red]❌ Opção inválida. Por favor, digite 1 ou 2.[/bold red]")
+        raise typer.Exit(code=1)

mlopstemplate/config.py

@@ -0,0 +1,40 @@
+"""Configurações e utilitários para autenticação e templates do MLOps Template."""
+
+import os
+from typing import Optional
+
+# URLs dos templates para cada perfil
+TEMPLATE_REPO_URL = "https://github.com/centro-dados-ia/cdiaTemplateMlops.git"
+TEMPLATE_REPO_URL_PESQUISA = "https://github.com/Insper-CDIA-Pesquisa/cdiaTemplateMlops.git"
+
+TOKEN_ENV_VAR = "GITHUB_TOKEN"
+TOKEN_FILE = os.path.join(os.path.expanduser("~"), ".mlops_token")
+
+
+def set_session_token(token: str):
+    """Armazena o token do GitHub como uma variável de ambiente para a sessão atual."""
+    os.environ[TOKEN_ENV_VAR] = token
+
+
+def save_token(token: str):
+    """Salva o token do GitHub em um arquivo de configuração local."""
+    with open(TOKEN_FILE, "w") as f:
+        f.write(token)
+
+
+def get_token() -> Optional[str]:
+    """
+    Obtém o token do GitHub, priorizando a variável de ambiente da sessão.
+    Se não encontrar, busca no arquivo de configuração local.
+    """
+    # 1. Prioriza o token da sessão (variável de ambiente)
+    token = os.environ.get(TOKEN_ENV_VAR)
+    if token:
+        return token
+
+    # 2. Se não houver, tenta ler do arquivo
+    if os.path.exists(TOKEN_FILE):
+        with open(TOKEN_FILE, "r") as f:
+            return f.read().strip()
+
+    return None

mlopstemplate/core.py

@@ -0,0 +1,193 @@
+"""Core logic for handling Git and GitHub operations."""
+
+import os
+from typing import List
+
+import typer
+
+import git
+from github import Github, GithubException, Repository
+from github.Organization import Organization
+from rich.console import Console
+
+console = Console()
+
+
+def clonar_template_com_nome(
+    template_repo_url: str, nome_projeto: str, destino_base: str = "."
+) -> str:
+    """
+    Clones a template repository into a new directory with a given name.
+
+    Args:
+        template_repo_url: The URL of the template repository to clone.
+        nome_projeto: The name of the new project and directory.
+        destino_base: The base directory where the new project will be created.
+
+    Returns:
+        The destination path of the cloned repository.
+    """
+    destino = os.path.join(destino_base, nome_projeto)
+    if os.path.exists(destino):
+        console.print(f"[red]❌ A pasta '{destino}' já existe. Por segurança, o processo será interrompido.[/red]")
+        console.print("[yellow]💡 Dica: Apague manualmente ou escolha outro nome para o repositório.[/yellow]")
+        raise typer.Exit(code=1)
+    console.print(f"🌱 Criando seu repositório em {destino}")
+    git.Repo.clone_from(template_repo_url, destino)
+    return destino
+
+
+def _get_or_create_repo(
+    org: 'Organization', repo_nome: str, visibilidade: str
+) -> 'Repository':
+    """Gets an existing repository or creates a new one."""
+    try:
+        return org.get_repo(repo_nome)
+    except GithubException as e:
+        if e.status == 404:
+            return org.create_repo(repo_nome, private=(visibilidade == "private"))
+        raise e
+
+
+def _init_and_configure_git(
+    pasta: str, repo_url: str, branches_to_push: List[str], repo_type: str
+) -> 'git.Repo':
+    """Initializes and configures the local Git repository."""
+    repo_git = git.Repo.init(pasta)
+
+    if "origin" in [remote.name for remote in repo_git.remotes]:
+        repo_git.remote("origin").set_url(repo_url)
+    else:
+        repo_git.create_remote("origin", repo_url)
+
+    # ⚠️ Cria commit inicial diretamente na branch 'dev'
+    repo_git.git.checkout("-b", "dev")
+    repo_git.git.add(A=True)
+
+    if repo_git.is_dirty(untracked_files=True):
+        repo_git.index.commit("Commit inicial do projeto")
+
+    # ⚙️ Cria a branch 'prod' a partir da 'dev' se for administrativo
+    if repo_type == "administrativo":
+        if "prod" not in [b.name for b in repo_git.branches]:
+            repo_git.create_head("prod", "dev")
+
+    # 🚀 Push das branches existentes
+    for branch in branches_to_push:
+        if branch in [b.name for b in repo_git.branches]:
+            repo_git.git.push("--set-upstream", "origin", branch)
+
+    return repo_git
+
+def _apply_branch_protection(repo: 'Repository', branch_name: str):
+    """Applies a comprehensive set of branch protection rules."""
+    try:
+        console.print(f"🛡️  Aplicando regras de proteção à branch '[bold]{branch_name}[/bold]'...")
+        branch = repo.get_branch(branch_name)
+        branch.edit_protection(
+            # Requer 1 aprovação em PRs
+            required_approving_review_count=1,
+            # Desabilita revisões obsoletas após novos pushes
+            dismiss_stale_reviews=True,
+            # Não permite deletar a branch
+            allow_deletions=False,
+            # Exige que o histórico de commits seja linear (impede merge fast-forward)
+            required_linear_history=True,
+            # Passando outras regras como kwargs, baseado na API do GitHub
+            require_code_owner_reviews=False,
+            required_conversation_resolution=False,
+        )
+        console.print(f"✅ Proteção da branch '[bold]{branch_name}[/bold]' configurada.")
+    except GithubException as e:
+        if e.status == 403:
+            console.print(f"[yellow]⚠️  Aviso: A proteção de branch em '{branch_name}' não foi aplicada (requer plano Pro/Team).[/yellow]")
+        else:
+            console.print(f"[red]❌ Erro ao proteger a branch '{branch_name}': {e}[/red]")
+    except Exception as e:
+        console.print(f"[red]❌ Erro inesperado ao proteger a branch '{branch_name}': {e}[/red]")
+
+
+def _set_repository_permissions(org: 'Organization', repo: 'Repository', g: 'Github'):
+    """Sets repository permissions for the admin team and the creator."""
+    try:
+        team = org.get_team_by_slug("cdia-admin")
+        team.set_repo_permission(repo, "admin")
+
+        creator = g.get_user()
+        if creator and creator.login:
+            repo.add_to_collaborators(creator.login, permission="push")
+            console.print(f"✅ Permissões configuradas: Equipe '[bold]CDIA-Admin[/bold]' é admin, usuário '[bold]{creator.login}[/bold]' é writer.")
+        else:
+            console.print("✅ Permissões configuradas: Equipe '[bold]CDIA-Admin[/bold]' é admin.")
+            console.print("[yellow]⚠️  Aviso: Não foi possível rebaixar o criador do repositório para 'writer' (usuário não identificado).[/yellow]")
+
+    except GithubException as e:
+        if e.status == 404:
+            console.print("[yellow]⚠️  Aviso: Equipe 'cdia-admin' não encontrada. Permissões de equipe não ajustadas.[/yellow]")
+        else:
+            console.print(f"[red]❌ Erro ao configurar permissões: {e}[/red]")
+
+def criar_repositorio(
+    github_token: str,
+    org_name: str,
+    pasta: str,
+    repo_type: str = "administrativo",
+    visibilidade: str = "private",
+):
+    """
+    Creates and configures a GitHub repository based on the specified type.
+
+    This function handles the entire workflow: creating the repo on GitHub,
+    configuring the local git repository, pushing branches, and setting up
+    permissions and protections.
+
+    Args:
+        github_token: The GitHub personal access token.
+        org_name: The name of the GitHub organization.
+        pasta: The local path to the project directory.
+        repo_type: The type of repository ('administrativo' or 'pesquisa').
+                   This determines the configuration applied.
+        visibilidade: The visibility of the repository ('private' or 'public').
+    """
+    with console.status("[bold green]Iniciando processo...") as status:
+        repo_nome = os.path.basename(os.path.abspath(pasta))
+        console.print(f"📝 Nome do repositório: [bold cyan]{repo_nome}[/bold cyan]")
+
+        status.update("Conectando ao GitHub e criando repositório...")
+        g = Github(github_token)
+        try:
+            org = g.get_organization(org_name)
+        except GithubException as e:
+            if e.status == 404:
+                console.print(f"[red]❌ Organização '{org_name}' não encontrada ou sem acesso.[/red]")
+                console.print("[yellow]💡 Dicas:[/yellow]")
+                console.print("   • Verifique se o nome da organização está correto")
+                console.print("   • Confirme se você tem acesso à organização")
+                console.print("   • Considere usar sua conta pessoal do GitHub")
+                raise e
+            else:
+                raise e
+        repo = _get_or_create_repo(org, repo_nome, visibilidade)
+        console.print("✅ Repositório criado com sucesso.")
+
+        status.update("Configurando repositório local e enviando branches...")
+        repo_url = repo.clone_url.replace("https://", f"https://{github_token}@")
+        branches_to_push = ["dev", "prod"] if repo_type == "administrativo" else ["dev"]
+        _init_and_configure_git(pasta, repo_url, branches_to_push, repo_type)
+        console.print("✅ Branches enviadas.")
+
+        status.update("Configurando permissões e proteções...")
+        if repo_type == "administrativo":
+            # Configura os métodos de merge permitidos para o repositório
+            repo.edit(
+                allow_merge_commit=True,
+                allow_squash_merge=True,
+                allow_rebase_merge=True,
+                delete_branch_on_merge=True, # Conveniência: apaga a branch após o merge
+            )
+            console.print("✅ Métodos de merge e configurações do repositório aplicados.")
+            _apply_branch_protection(repo, "dev")
+            _apply_branch_protection(repo, "prod")
+        _set_repository_permissions(org, repo, g)
+
+    console.print("✅ Processo concluído com sucesso!")